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

Hướng dẫn thiết lập API Key cho Pi Coding Agent — models.json & auth.json

Cách cấu hình Pi Coding Agent với API key tùy chỉnh và base URL tương thích OpenAI từ APIMaster.ai. Thiết lập models.json và auth.json trên Windows và macOS để dùng GPT-5.4, Claude và DeepSeek.

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