在 Pi 中使用 AIGOKEY

开始前准备好 API Key 和一个 AIGOKEY 实际支持的模型 ID。下面的示例使用环境变量保存密钥。

Pi 默认从用户目录读取模型配置。文件不存在时可以直接创建，目录名中的点号不要省略。

1. 退出正在运行的 Pi 会话。
2. 打开终端，进入 ~/.pi/agent 目录。
3. 创建或编辑 models.json，并粘贴下一节的完整配置。
4. 在当前终端设置 AIGOKEY_API_KEY 环境变量。

将下面配置保存为 models.json。只需要把 your-model-id 替换成实际模型 ID；如果模型支持图片输入或推理，请同步调整对应字段。

{
  "providers": {
    "aigokey": {
      "name": "AIGOKEY",
      "baseUrl": "https://llm.aigokey.cn/v1",
      "apiKey": "$AIGOKEY_API_KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "your-model-id",
          "name": "AIGOKEY Model",
          "reasoning": false,
          "input": ["text"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 128000,
          "maxTokens": 4096
        }
      ]
    }
  }
}

Pi 用模型对象决定模型是否可选，以及如何展示能力和用量。价格字段用于 Pi 的用量跟踪，不会改变 AIGOKEY 的实际计费。

• 文本模型使用 input: ["text"]；视觉模型再加入 "image"。
• 不支持思考时保持 reasoning: false；不要为了显示选项而误设为 true。
• contextWindow 与 maxTokens 按模型真实限制填写。

保存配置并设置密钥后，重新启动 Pi。自定义模型会出现在模型列表中。

先检查文件路径、JSON 格式和模型 ID，再重启 Pi 验证。