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

账单

已公布价格

每种协议一个提供方

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 的各个等级会映射到每个模型自身的推理控制；模型不支持的等级会向上取最接近的可用等级。