Pi

1. 领取 SupaNexus API Key

登录开发者控制台，进入项目 → API Keys，创建 Key 并立即复制（仅展示一次）。同一把项目 Key 可用于 OpenAI 兼容与 Anthropic 兼容客户端。

2. 安装 Pi

按官方文档安装 Pi，确认 Agent CLI 可启动。

# see https://pi.dev for current installers
pi --help

3. 创建或编辑 models.json

路径：~/.pi/agent/models.json。添加非内置提供方：api 为 openai-completions，baseUrl 以 /v1 结尾，并至少配置一个型号（id、name、contextWindow、maxTokens、cost）。apiKey 可写在文件、auth.json 或 CLI --api-key。

{
  "providers": {
    "supanexus": {
      "baseUrl": "<BASE_URL>/v1",
      "api": "openai-completions",
      "apiKey": "sk-snx-...",
      "models": [
        {
          "id": "deepseek/deepseek-chat",
          "name": "DeepSeek Chat",
          "reasoning": false,
          "input": ["text"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 128000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

4. 兼容开关（按需）

若网关不接受 developer 角色或 reasoning_effort，在提供方级 compat 将 supportsDeveloperRole / supportsReasoningEffort 设为 false，让 Pi 退回 system 消息。

"compat": {
  "supportsDeveloperRole": false,
  "supportsReasoningEffort": false
}

5. 选用目录型号 ID

型号 ID 以 SupaNexus 模型市场或 GET /v1/models 为准（例如 deepseek/deepseek-chat、anthropic/claude-3-5-sonnet）。不要套用其它网关的自创 slug。

6. 重载并用 /model 选择

重启 Pi（或重新加载型号）。执行 /model 或 --list-models，选中 SupaNexus 条目。未配置鉴权时型号可能可见但不可用。

7. 排障

看不到型号：JSON 须合法且位于 ~/.pi/agent/。401：apiKey / auth 未加载。部分 OpenAI 兼容差异：按上调整 compat；对接 SupaNexus 这类 Chat Completions 网关时 api 保持 openai-completions。