Оформление
Подключение 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 |
baseUrl | https://1app.ru/v1, без /chat/completions и повторного /v1 |
api | openai-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 по моделям. Набор полей и поведение могут различаться между версиями клиента.