Pi API 接入:配置与常见问题

Pi 是开源的终端编程 Agent,核心很小,靠扩展增加能力。自定义端点写在 `models.json` 里,不需要写扩展。

更新日期:

配置 FlyRouter

设置 API Key

终端
export FLYROUTER_API_KEY="sk-..."

添加供应商

编辑 ~/.pi/agent/models.json,没有这个文件就新建:

~/.pi/agent/models.json
{
  "$schema": "https://pi.dev/schemas/models.schema.json",
  "providers": {
    "flyrouter": {
      "baseUrl": "https://api.flyrouter.ai/v1",
      "api": "openai-completions",
      "apiKey": "$FLYROUTER_API_KEY",
      "models": [
        { "id": "claude-sonnet-5-5", "name": "Claude Sonnet 5.5", "input": ["text", "image"] },
        { "id": "gpt-6.1-sol", "name": "GPT-6.1 Sol", "input": ["text", "image"] }
      ]
    }
  }
}

apiKey 写成 $变量名 时从环境变量读取,也可以直接写 Key。models 里的 id 是发送给接口的模型 ID。

选择模型

在 Pi 里输入 /model,选择 FlyRouter 下的模型。每次打开 /model 都会重新读取 models.json,改完不用重启。

按需填写模型参数

没有填写时,Pi 按 128,000 的上下文长度和 16,384 的最大输出处理。模型的实际限制不同的话,在对应条目里加上 contextWindow 和 maxTokens;支持思考的模型加 "reasoning": true。

常见问题

  • 404:baseUrl 需要带 /v1。
  • 401:环境变量没有生效,或 apiKey 里的变量名写错。
  • 费用显示为 $0.00:Pi 的费用是按 models.json 里的 cost 估算的,没有填写时显示为 0。实际扣费以 FlyRouter 控制台的用量记录为准。