Перейти к содержимому

Подключение Pi ​

Сложность ⌨️ Средний уровень (JSON-файл конфигурации) | Формат API OpenAI-совместимый | base_url https://1app.ru/v1

Эта инструкция для уже установленного Pi. Подключение к 1APP настраивается через файл models.json: добавьте провайдер, укажите токен и выберите модель.

Шаг 1: подготовьте токен ​

В консоли 1APP откройте раздел «Токены» и создайте токен в группе, которая покрывает нужную модель. Подробнее — Выбор группы.

Перед запуском Pi задайте переменную ONEAPP_API_KEY в том же терминале. Вместо sk-ваш-токен подставьте собственный ключ:

bash
export ONEAPP_API_KEY='sk-ваш-токен'
powershell
$env:ONEAPP_API_KEY = 'sk-ваш-токен'

Переменная действует в текущем терминале и запущенных из него процессах. При открытии нового терминала задайте её снова. Не публикуйте ключ и не добавляйте его в репозиторий.

Шаг 2: добавьте провайдер 1APP ​

Откройте или создайте файл ~/.pi/agent/models.json (в Windows — %USERPROFILE%\.pi\agent\models.json). Если каталога нет, создайте его. Если вы изменили каталог данных Pi, используйте models.json в этом каталоге.

Сохраните существующие настройки

Если файл уже существует, добавьте только запись 1app внутрь существующего объекта providers. Не заменяйте другие провайдеры и не создавайте второй объект providers.

Для нового файла используйте:

json
{
  "providers": {
    "1app": {
      "baseUrl": "https://1app.ru/v1",
      "api": "openai-completions",
      "apiKey": "$ONEAPP_API_KEY",
      "models": [
        { "id": "claude-sonnet-5" }
      ]
    }
  }
}
ПолеЧто указать
1appИдентификатор нового провайдера в Pi
baseUrlhttps://1app.ru/v1, без /chat/completions и повторного /v1
apiopenai-completions — название адаптера Pi для Chat Completions
apiKey$ONEAPP_API_KEY — подстановка значения переменной окружения, а не сам ключ
models[].idТочный идентификатор модели из каталога 1APP, доступной группе вашего токена

В примере используется claude-sonnet-5. Для другой модели замените id; для нескольких — добавьте объекты в массив models. Pi не заполняет этот список автоматически из каталога 1APP.

Шаг 3: выберите модель и проверьте подключение ​

В том же терминале запустите Pi:

bash
pi

Введите /model, найдите провайдер 1app и выберите claude-sonnet-5 или другую добавленную модель. Открытие /model перечитывает models.json; после изменения переменной окружения перезапустите Pi из терминала, где она задана.

Отправьте короткий запрос, например: «Ответь одним словом: подключено». Ответ без ошибки подтверждает, что запрос прошёл через 1APP.

Расходы

Использование списывается с баланса или квоты 1APP по действующим условиям выбранной модели. Историю запросов и списаний проверяйте в консоли 1APP; оценка стоимости в Pi не заменяет данные биллинга.

Возникли проблемы? ​

  • Модель не появилась в /model. Проверьте расположение и синтаксис models.json, наличие записи в models и переменной ONEAPP_API_KEY в окружении процесса Pi. Затем снова откройте /model.
  • 401 / invalid token. Проверьте токен, его срок действия и отсутствие лишних пробелов. Если для провайдера 1app уже сохранены другие учётные данные через /login, удалите их через /logout: сохранённые данные имеют приоритет над apiKey из models.json.
  • No available channel. Группа токена не покрывает модель либо сейчас нет доступного канала. Проверьте группу и описание ошибки.
  • Model not found. Сверьте models[].id с каталогом 1APP. Используйте идентификатор, а не отображаемое название модели.
  • 404 или неверный маршрут. В baseUrl должно быть https://1app.ru/v1, без дописанного /chat/completions.
  • Другие случаи — Частые ошибки и решения.

Официальная справка Pi ​

Подробности настройки провайдеров — в документации Pi по моделям. Набор полей и поведение могут различаться между версиями клиента.