Chatbox API: подключение и настройка моделей
Chatbox подключает шлюз как провайдер OpenAI API compatible с раздельными полями API Host и API Path. Официальная страница и обсуждения расходятся в правиле /, поэтому нужна пробная проверка.
- Тип: Чат и настольное приложение
- Протокол: OpenAI Chat Completions
- Статус: Частично
Что заработает
| Возможность | Отметка | Примечание |
|---|---|---|
| Чат | Да | |
| Потоковый ответ | Да | |
| Вызов инструментов | Частично | Нужно включить возможности модели вручную. |
| Картинки на входе | Частично | Нужно включить возможности модели вручную. |
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
- Откройте Settings, добавьте провайдера и выберите тип OpenAI API compatible.
- В API Host введите
https://, в API Path оставьтеrelay-llm.ru /, в поле ключа введите ключ.v1/ chat/ completions - Добавьте модель по идентификатору из каталога, например
gpt-5.6-luna, и выберите её в чате.
Поля провайдера
Provider: OpenAI API compatible
API Host: https://relay-llm.ru
API Path: /v1/chat/completions
API Key: YOUR_API_KEY
Model: gpt-5.6-lunaПроверка
Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.
macOS и Linux
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Отправьте «ping» в чате. Если приходит 404, поменяйте хост (добавьте или уберите /). Запись видна в журнале кабинета.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
Ловушки
- Источники расходятся: одни пишут хост с
/и путьv1 /, в обсуждении репозитория описана нормализация, которая добавляетchat/ completions /сама. Проверьте запрос пробой и поправьте хост.v1 - Новые модели Chatbox считает текстовыми. Пока вы не включите возможности модели, ни картинки на входе, ни инструменты работать не будут.
- Тип Custom OpenAI Responses не выбирайте для шлюза Chat Completions. Свой адрес для встроенного провайдера Claude в документации не подтверждён.
Ссылки
Официальная документация: Chatbox API: подключение и настройка моделей
Подключение клиентов: общие сведения и все клиенты