APIMaster.ai
Documentação APIMaster.ai
Quick startAPIMaster.aiMarketplace

Pi Coding Agent + APIMaster.ai

Configure o Pi Coding Agent com models.json e auth.json para a API compatível com OpenAI da APIMaster no Windows e macOS.

Pi Coding Agent é um agente de codificação de terminal. Adicione o provedor apimaster via ~/.pi/agent/models.json para usar a API compatível com OpenAI da APIMaster.

Obtenha uma Chave de API primeiro. Os IDs dos modelos correspondem ao marketplace e ao GET /v1/models.

Diretório de configuração

Plataforma Caminho
Windows C:\Users\<nome_do_usuario>\.pi\agent\
macOS / Linux ~/.pi/agent/

Arquivos: models.json (provedor + modelos), auth.json (armazenamento opcional de chave de API).

models.json

O nível superior deve ser providers. Use UTF-8 sem BOM no 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 (opcional)

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

Variáveis de ambiente

Windows (PowerShell, sessão):

$env:APIMASTER_API_KEY="sua_chave_apimaster"

Windows (persistente):

[Environment]::SetEnvironmentVariable("APIMASTER_API_KEY", "sua_chave_apimaster", "User")

macOS / Linux:

export APIMASTER_API_KEY="sua_chave_apimaster"
echo 'export APIMASTER_API_KEY="sua_chave_apimaster"' >> ~/.zshrc

Verificar

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

Solução de problemas

  • models.json deve usar a raiz providers — não um objeto apiKey simples.
  • UTF-8 BOM no Windows quebra o JSON.parse — salve sem BOM.
  • Modelos ausentes — verifique o caminho ~/.pi/agent/models.json (ou o equivalente no perfil do usuário Windows).

Relacionados