Как подключить Pi к Tokenator API

Что получится в итоге

После настройки Pi перестаёт обращаться к своему стандартному провайдеру и отправляет все запросы в Tokenator. Оплата идёт токенами вашего ключа, а список доступных моделей задаётся ключом, а не инструментом.

Требования и поддерживаемые ОС

• Windows 10/11, macOS 12+ или современный Linux с 64-битной архитектурой.
• Доступ в интернет к домену Tokenator по HTTPS.
• API-ключ Tokenator вида sk-your-tokenator-key.

Нужны Node.js с npm и терминал. Файл со своими провайдерами создаётся вручную, редактор подойдёт любой.

Установка Pi

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Флаг --ignore-scripts отключает lifecycle-скрипты зависимостей: для обычной установки Pi они не нужны. Запускается агент командой pi из каталога проекта.

Настройка Tokenator

1. Зарегистрируйтесь в личном кабинете и купите пакет токенов.
2. Ключ появится в кабинете сразу после подтверждения оплаты — копировать его нужно целиком, вместе с префиксом.
3. В примерах ниже вместо настоящего ключа стоит плейсхолдер sk-your-tokenator-key. Не публикуйте настоящий ключ в репозиториях и скриншотах.

Конфигурация

1. Создайте файл ~/.pi/agent/models.json; на Windows это %USERPROFILE%\.pi\agent\models.json.
2. Опишите в нём провайдера: адрес, протокол, ключ и список моделей.
3. Положите ключ в переменную окружения TOKENATOR_API_KEY — в файле остаётся только ссылка на неё.
4. Запустите pi и откройте /model (или Ctrl+L): файл перечитывается при каждом открытии пикера.

{
  "providers": {
    "tokenator": {
      "baseUrl": "https://api.tokenator.top/v1",
      "api": "openai-completions",
      "apiKey": "$TOKENATOR_API_KEY",
      "models": [
        { "id": "gpt-5.5" }
      ]
    }
  }
}

Обязательный минимум у модели — только id. Остальные поля (name, contextWindow, maxTokens, input, cost) задают то, как модель выглядит и считается в интерфейсе, и заполняются по желанию.

Первый запрос

Перед запуском инструмента полезно убедиться, что ключ и модель рабочие. Один запрос curl отвечает на оба вопроса сразу.

curl https://api.tokenator.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-tokenator-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "ping"}]
  }'

cd /path/to/project
pi

Откройте /model (или Ctrl+L) и выберите модель провайдера tokenator. Ctrl+S в пикере сохраняет подсвеченную модель как стартовую по умолчанию.

Успешный ответ означает, что ключ действителен, модель разрешена для этого ключа и апстрим доступен. Расход виден в кабинете сразу после запроса.

Переключение моделей

Каждая модель — элемент массива models в ~/.pi/agent/models.json. Файл перечитывается при открытии /model, поэтому добавленная модель появляется в пикере без перезапуска агента.

Примеры ID моделей, доступных сейчас:

• claude-haiku-4-5
• claude-opus-4-6
• claude-opus-4-7
• claude-sonnet-4-6
• gpt-5.5
• deepseek-v4-pro

Актуальные ID и характеристики — в каталоге AI-моделей; там же видно, какие модели сейчас доступны. Выбрать между близкими вариантами помогает сравнение моделей.

Настройка reasoning

Рассуждающая модель помечается в models.json признаком "reasoning": true. Если сервер не принимает поле reasoning_effort, в блоке compat провайдера ставится "supportsReasoningEffort": false, а если он не понимает роль developer — "supportsDeveloperRole": false: тогда системный промпт уходит обычным system-сообщением. compat задаётся на уровне провайдера для всех моделей или на уровне конкретной модели.

Переключатель reasoning у ключа в личном кабинете работает независимо от инструмента, а размышление тарифицируется как output-токены.

Частые ошибки и способы исправления

Частые вопросы

Читайте дальше