APIMaster.ai

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).

Связанные материалы