APIMaster.ai
Tài liệu APIMaster.ai
Quick startAPIMaster.aiMarketplace

Pi Coding Agent + APIMaster.ai

Cấu hình Pi Coding Agent với models.json và auth.json cho API tương thích OpenAI của APIMaster trên Windows và macOS.

Pi Coding Agent là một tác nhân mã hóa trong terminal. Thêm nhà cung cấp apimaster qua ~/.pi/agent/models.json để sử dụng API tương thích OpenAI của APIMaster.

Lấy API Key trước. ID mô hình khớp với marketplace và GET /v1/models.

Thư mục cấu hình

Nền tảng Đường dẫn
Windows C:\Users\<username>\.pi\agent\
macOS / Linux ~/.pi/agent/

Tệp: models.json (nhà cung cấp + mô hình), auth.json (tùy chọn lưu trữ API key).

models.json

Cấp cao nhất phải là providers. Sử dụng UTF-8 không BOM trên Windows.

{
  "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 (tùy chọn)

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

Biến môi trường

Windows (PowerShell, phiên):

$env:APIMASTER_API_KEY="your_apimaster_key"

Windows (vĩnh viễn):

[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

Xác minh

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

Khắc phục sự cố

  • models.json phải có gốc providers — không phải đối tượng apiKey trần.
  • UTF-8 BOM trên Windows làm hỏng JSON.parse — lưu mà không có BOM.
  • Thiếu mô hình — kiểm tra đường dẫn ~/.pi/agent/models.json (hoặc tương đương hồ sơ người dùng Windows).

Liên quan