pi 程式設計代理

透過 Aiduct 執行 pi 程式設計代理。

pi 會從 ~/.pi/agent/models.json 讀取自訂供應商。Aiduct 支援 pi 的所有 API，每個模型都能使用最適合的協議。

~/.PI/AGENT/MODELS.JSON

{
  "providers": {
    "aiduct": {
      "baseUrl": "https://api.aiduct.ai/v1",
      "api": "openai-completions",
      "apiKey": "$AIDUCT_API_KEY",
      "models": [{ "id": "deepseek-v4.1-flash" }, { "id": "glm-5.3" }]
    },
    "aiduct-claude": {
      "baseUrl": "https://api.aiduct.ai",
      "api": "anthropic-messages",
      "apiKey": "$AIDUCT_API_KEY",
      "models": [{ "id": "claude-sonnet-5", "input": ["text", "image"] }]
    }
  }
}

設定

models.json

協議

Messages + Chat

帳單

Published pricing

每種協議一個供應商

Claude 模型透過 Anthropic Messages 原生回應，完整保留延伸思考與提示快取；目錄中的其他模型皆可透過 OpenAI chat 使用。請將每個供應商指向其協議所需的 base URL。

不要把金鑰寫進檔案

pi 會在發送請求時從環境變數展開 $AIDUCT_API_KEY，因此 models.json 中不會保存任何金鑰。

常見問題

pi 的各個 API 分別使用哪個 base URL？+

openai-completions 與 openai-responses 使用 https://api.aiduct.ai/v1；anthropic-messages 與 google-generative-ai 使用 https://api.aiduct.ai，因為它們的 SDK 會自行加上版本路徑。

pi 能透過 Aiduct 使用 Gemini 模型嗎？+

可以。新增一個使用 google-generative-ai API 與閘道根網址的供應商，或透過 openai-completions 使用任何 Gemini 模型。

pi 的思考等級有效嗎？+

有效。pi 從 off 到 max 的各個等級會對應到每個模型自身的推理控制；模型不支援的等級會往上取最接近的可用等級。