吉格api 文档

切换主题

pi 接入 ​

pi 支持通过自定义 provider 连接 OpenAI Chat Completions 兼容接口。以下配置只填写稳定字段，模型能力参数以模型广场和实际调用为准。

配置 ​

1. 安装 ​

pi 当前包要求较新的 Node.js。先确认本机 Node.js 满足 pi 官方要求，再安装：

bash
npm install -g @earendil-works/pi-coding-agent
pi --version

包名变化

旧的 @mariozechner/pi-coding-agent 已弃用。新安装请使用 @earendil-works/pi-coding-agent，并以 pi 官方文档中的最新包名为准。

2. 设置密钥 ​

macOS / Linux：

bash
export JIGE_API_KEY="YOUR_API_KEY"

Windows PowerShell：

powershell
$env:JIGE_API_KEY = "YOUR_API_KEY"

3. 编辑模型配置 ​

创建或编辑 ~/.pi/agent/models.json：

json
{
  "providers": {
    "jigeapi": {
      "baseUrl": "https://chickener.cc.cd/v1",
      "api": "openai-completions",
      "apiKey": "$JIGE_API_KEY",
      "models": [
        {
          "id": "YOUR_MODEL_ID"
        }
      ]
    }
  }
}

将 YOUR_MODEL_ID 替换为模型广场中的实际模型 ID。

4. 启动 ​

bash
pi --provider jigeapi --model YOUR_MODEL_ID

也可以在 pi 中使用 /model 重新加载并选择模型。

要点 ​

  • baseUrl 填写到 /v1，不要追加 /chat/completions。
  • api 使用 openai-completions。
  • apiKey 中的 $JIGE_API_KEY 表示读取环境变量；如果省略 $，pi 会把文本当作密钥本身。
  • 不在文档中写死 contextWindow 或 maxTokens，这些值取决于具体模型。
  • 只有在实际返回兼容性错误时，才按 pi 官方文档增加能力开关，不要先抄一整套未经验证的参数。

常见问题 ​

提示没有 API Key ​

确认当前终端能够读取 JIGE_API_KEY，并检查配置中是否写成了 "$JIGE_API_KEY"。修改持久化环境变量后需要重新打开终端。

提示模型不存在 ​

模型 ID 必须与模型广场完全一致。修改 models.json 后使用 /model 重新加载，或重启 pi。

请求路径出现 404 ​

确认 baseUrl 是 https://chickener.cc.cd/v1，不要手动追加 /chat/completions，pi 会根据 api 自动拼接端点。

流式输出或参数不兼容 ​

不同模型对 developer role、reasoning effort、流式 usage 和最大输出字段的支持可能不同。先保留最小配置，再根据实际错误参照 pi 的 provider 能力开关处理。