К содержимому

Chatbox API: подключение и настройка моделей

Chatbox подключает шлюз как провайдер OpenAI API compatible с раздельными полями API Host и API Path. Официальная страница и обсуждения расходятся в правиле /v1, поэтому нужна пробная проверка.

  • Тип: Чат и настольное приложение
  • Протокол: OpenAI Chat Completions
  • Статус: Частично
Сверено частично, 2026-10-02: в документации клиента есть пробел или источники расходятся. Не проверено вручную. Что проверить пробой, описано в разделе «Ловушки».

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Потоковый ответДа
Вызов инструментовЧастичноНужно включить возможности модели вручную.
Картинки на входеЧастичноНужно включить возможности модели вручную.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

  1. Откройте Settings, добавьте провайдера и выберите тип OpenAI API compatible.
  2. В API Host введите https://relay-llm.ru, в API Path оставьте /v1/chat/completions, в поле ключа введите ключ.
  3. Добавьте модель по идентификатору из каталога, например gpt-5.6-luna, и выберите её в чате.

Поля провайдера

text
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

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Отправьте «ping» в чате. Если приходит 404, поменяйте хост (добавьте или уберите /v1). Запись видна в журнале кабинета.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Ловушки

  • Источники расходятся: одни пишут хост с /v1 и путь /chat/completions, в обсуждении репозитория описана нормализация, которая добавляет /v1 сама. Проверьте запрос пробой и поправьте хост.
  • Новые модели Chatbox считает текстовыми. Пока вы не включите возможности модели, ни картинки на входе, ни инструменты работать не будут.
  • Тип Custom OpenAI Responses не выбирайте для шлюза Chat Completions. Свой адрес для встроенного провайдера Claude в документации не подтверждён.

Официальная документация: Chatbox API: подключение и настройка моделей

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key