Pi Coding Agent + APIMaster.ai
Настройка Pi Coding Agent с файлами models.json и auth.json для OpenAI-совместимого API APIMaster на Windows и macOS.
Pi Coding Agent — это терминальный кодинг-агент. Добавьте провайдер apimaster через ~/.pi/agent/models.json, чтобы использовать OpenAI-совместимый API APIMaster.
Сначала получите API-ключ. Идентификаторы моделей соответствуют маркетплейсу и
GET /v1/models.
Директория конфигурации
| Платформа | Путь |
|---|---|
| Windows | C:\Users\<username>\.pi\agent\ |
| macOS / Linux | ~/.pi/agent/ |
Файлы: models.json (провайдер + модели), auth.json (опциональное хранилище API-ключей).
models.json
Верхний уровень должен быть providers. Используйте UTF-8 без BOM на 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 (опционально)
{
"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.- UTF-8 BOM на Windows ломает
JSON.parse— сохраняйте без BOM. - Отсутствуют модели — проверьте путь
~/.pi/agent/models.json(или эквивалент в профиле пользователя Windows).