Pi Coding Agent + APIMaster.ai
Configura Pi Coding Agent con models.json y auth.json para la API compatible con OpenAI de APIMaster en Windows y macOS.
Pi Coding Agent es un agente de codificación de terminal. Añade el proveedor apimaster mediante ~/.pi/agent/models.json para usar la API compatible con OpenAI de APIMaster.
Obtén una API Key primero. Los IDs de modelos coinciden con el marketplace y
GET /v1/models.
Directorio de configuración
| Plataforma | Ruta |
|---|---|
| Windows | C:\Users\<username>\.pi\agent\ |
| macOS / Linux | ~/.pi/agent/ |
Archivos: models.json (proveedor + modelos), auth.json (almacén opcional de claves API).
models.json
El nivel superior debe ser providers. Usa UTF-8 sin BOM en 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": "your_apimaster_key"
}
}
Variables de entorno
Windows (PowerShell, sesión):
$env:APIMASTER_API_KEY="your_apimaster_key"
Windows (persistente):
[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
Verificar
pi --list-models
pi --provider apimaster --model gpt-5.5
Solución de problemas
models.jsondebe usarproviderscomo raíz — no un objetoapiKeysimple.- UTF-8 BOM en Windows rompe
JSON.parse— guarda sin BOM. - Modelos faltantes — verifica la ruta
~/.pi/agent/models.json(o el equivalente del perfil de usuario en Windows).