APIMaster.ai
APIMaster.ai 문서
Quick startAPIMaster.aiMarketplace

Pi Coding Agent + APIMaster.ai

Windows 및 macOS에서 APIMaster OpenAI 호환 API를 위해 models.json 및 auth.json으로 Pi Coding Agent를 구성합니다.

Pi Coding Agent 는 터미널 코딩 에이전트입니다. APIMaster의 OpenAI 호환 API를 사용하려면 ~/.pi/agent/models.json을 통해 apimaster 공급자를 추가하세요.

먼저 API Key를 받으세요. 모델 ID는 마켓플레이스 및 GET /v1/models와 일치합니다.

Config directory

플랫폼 경로
Windows C:\Users\<username>\.pi\agent\
macOS / Linux ~/.pi/agent/

파일: models.json (공급자 + 모델), auth.json (선택적 API 키 저장소).

models.json

최상위 레벨은 providers 여야 합니다. Windows에서는 UTF-8 BOM 없이 사용하세요.

{
  "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 사용자 프로필의 해당 경로)을 확인하세요.

관련 항목