APIMaster.ai
APIMaster.ai 使用文件
快速開始APIMaster 官網模型廣場

Pi Coding Agent + APIMaster.ai

在 Windows 和 macOS 上使用 models.json 和 auth.json 配置 Pi Coding Agent 以連接 APIMaster OpenAI 兼容 API。

Pi Coding Agent 是一個終端編碼代理。通過 ~/.pi/agent/models.json 添加提供商 apimaster，以使用 APIMaster 的 OpenAI 兼容 API。

首先獲取 API 金鑰。模型 ID 與市場和 GET /v1/models 匹配。

配置目錄

平台 路徑
Windows C:\Users\<username>\.pi\agent\
macOS / Linux ~/.pi/agent/

文件：models.json（提供商 + 模型）、auth.json（可選 API 金鑰存儲）。

models.json

頂層必須是 providers。在 Windows 上使用 無 BOM 的 UTF-8。

{
  "providers": {
    "apimaster": {
      "baseUrl": "https://apimaster.ai/v1",
      "api": "openai-completions",
      "apiKey": "$APIMASTER_API_KEY",
      "models": [
        { "id": "claude-haiku-4-5", "name": "Claude Haiku 4.5 via apimaster", "reasoning": true, "contextWindow": 128000, "maxTokens": 16384 },
        { "id": "claude-opus-4-7", "name": "Claude Opus 4.7 via apimaster", "reasoning": true, "contextWindow": 128000, "maxTokens": 16384 },
        { "id": "claude-opus-4-8", "name": "Claude Opus 4.8 via apimaster", "reasoning": true, "contextWindow": 128000, "maxTokens": 16384 },
        { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6 via apimaster", "reasoning": true, "contextWindow": 128000, "maxTokens": 16384 },
        { "id": "gpt-5.4", "name": "GPT 5.4 via apimaster", "reasoning": true, "contextWindow": 128000, "maxTokens": 16384 },
        { "id": "gpt-5.5", "name": "GPT 5.5 via apimaster", "reasoning": true, "contextWindow": 128000, "maxTokens": 16384 },
        { "id": "minimax-m3", "name": "MiniMax M3 via apimaster", "reasoning": true, "contextWindow": 128000, "maxTokens": 16384 }
      ]
    }
  }
}

auth.json（可選）

{
  "apimaster": {
    "type": "api_key",
    "key": "your_apimaster_key"
  }
}

環境變數

Windows（PowerShell，工作階段）：

$env:APIMASTER_API_KEY="your_apimaster_key"

Windows（持久化）：

[Environment]::SetEnvironmentVariable("APIMASTER_API_KEY", "your_apimaster_key", "User")

macOS / Linux：

export APIMASTER_API_KEY="your_apimaster_key"
echo 'export APIMASTER_API_KEY="your_apimaster_key"' >> ~/.zshrc

驗證

pi --list-models
pi --provider apimaster --model gpt-5.5

故障排除

  • models.json 必須使用 providers 作為根 — 而不是單獨的 apiKey 對象。
  • Windows 上的 UTF-8 BOM 會破壞 JSON.parse — 請儲存為無 BOM 格式。
  • 缺少模型 — 檢查路徑 ~/.pi/agent/models.json（或 Windows 用戶設定檔的對應路徑）。

相關