models.json. В примере используется BetterToken: задайте ключ, укажите Base URL для выбранного протокола и Model ID. Для другого сервиса используйте его URL, ключ и идентификаторы моделей.
Ключевые параметры
Подготовка
- Node.js 22.19 или новее.
- Создайте BetterToken API Key и выберите в model plaza модель с вызовами инструментов.
- Для Bash-инструмента Pi в Windows установите Git for Windows либо запускайте Pi в WSL.
Установка
Используйте текущую официальную команду установки через npm:Ручная настройка
Задайте API Key
В терминале, из которого запустите Pi, заменитеYOUR_API_KEY своим ключом:
- macOS / Linux
- Windows PowerShell
Получите модели и создайте настройки
Нажмите Получить список моделей, чтобы загрузить актуальный публичный каталог BetterToken без ввода API Key. Выберите API и модели с поддержкой вызова инструментов, затем скопируйте Model ID или скачайте готовыйmodels.json.
Если models.json уже существует, объедините созданную запись bettertoken с текущими настройками вместо замены всего файла. Настройки используют переменную $BETTERTOKEN_API_KEY, заданную выше; другие параметры модели при необходимости добавьте вручную.
Pi поддерживает несколько протоколов: выбирайте тот, который поддерживают модель и сервер. Для этого подключения рекомендуем Anthropic Messages для Claude, Responses для GPT при поддержке сервером и Chat Completions для других OpenAI-совместимых моделей. По умолчанию выбран Chat Completions; список фильтруется по API, указанным в публичном каталоге. Если нужной модели нет в списке Responses, используйте пример ниже для ручной настройки модели с подтверждённой поддержкой Responses.
Добавьте URL и модель
Создайте~/.pi/agent/models.json. В Windows путь по умолчанию — %USERPROFILE%\.pi\agent\models.json. Если файл уже есть, добавьте запись bettertoken в существующий объект providers.
Вместо созданных настроек можно вручную заполнить пример для Responses API ниже. Замените YOUR_MODEL_ID идентификатором из model plaza; сохраните $BETTERTOKEN_API_KEY как ссылку на переменную окружения:
baseUrl и api:
Выберите API с поддержкой вызовов инструментов для вашей модели. Например, GPT-6.1 Sol использует Responses. Оставьте Base URL в указанном виде: Pi добавит путь запроса.
Запустите Pi
Из каталога проекта выполните команду со своим Model ID:Проверка подключения
Выполнитеpi --list-models и найдите bettertoken и свою модель. Затем запустите Pi и отправьте:
PI_OK, проверьте вызовы инструментов на небольшой задаче только для чтения.
Смена модели
Добавьте модели в массивmodels и выполните /model в Pi. Команда перечитает models.json. Выберите модель и нажмите Ctrl+S, чтобы сохранить ее для новых сеансов. Для разных протоколов используйте отдельные локальные имена с собственными api и baseUrl.
Частые ошибки
Расширенная настройка
Для изображений, уровней рассуждения и большого контекста задайтеinput, reasoning, contextWindow и maxTokens по реальным возможностям модели. См. руководство по выбору модели.
Технические детали
providers и --provider — поля клиентской конфигурации Pi; bettertoken — локальное имя в примере. Pi сначала использует --api-key, затем сохраненные данные из auth.json, после них — apiKey из models.json. Если для этого имени сохранен старый ключ, удалите соответствующую запись через /logout в Pi и подключитесь снова.