Добавьте каждую модель каталога в Chatbox одним кастомным провайдером.

Updated 2026-07-29

Chatbox поставляется с потоком Add Custom Provider для любого OpenAI-совместимого эндпоинта: выберите режим OpenAI API Compatible, задайте API Host как https://api.apisrouter.com/v1, вставьте один ключ — и ID Claude, GPT, Gemini и DeepSeek окажутся бок о бок в пикере моделей на десктопе, мобильном и в вебе.

Короткий ответ: один диалог в настройках Model Provider.

Откройте настройки Chatbox и переключитесь на вкладку Model Provider. Нажмите Add, затем Add Custom Provider. Заполните диалог пятью значениями: Name (APIsRouter), API Mode, установленный в OpenAI API Compatible, свой ключ в API Key, https://api.apisrouter.com/v1 в API Host, и оставьте API Path на значении по умолчанию /chat/completions, которое Chatbox заполняет для хоста, заканчивающегося на /v1. Затем добавьте модели. Кнопка Fetch подтягивает список моделей эндпоинта через /v1/models, так что вы можете включать ID прямо из каталога, а New позволяет ввести ID вручную, если предпочитаете короткий курируемый пикер. Нажмите Check рядом с полем ключа, и Chatbox выполнит живой запрос; зелёное подтверждение означает, что провайдер подключён. Мы проверили именно этот поток на текущем веб-приложении Chatbox, и тот же диалог поставляется в десктопной и мобильной сборках.

Как Chatbox общается с кастомным провайдером.

Chatbox (chatboxai на GitHub, около 41K звёзд) — один из самых установленных ИИ-чат-клиентов: нативные приложения для Windows, macOS и Linux, мобильные сборки для iOS и Android, браузерная версия на web.chatboxai.app. Он поставляется с фирменными записями для крупных вендоров, каждая из которых хочет свой ключ, а диалог кастомного провайдера — задокументированный путь для всего остального. Кастомный провайдер в режиме OpenAI API Compatible — это простое описание эндпоинта: хост, путь, ключ и список ID моделей. Каждый ход разговора становится стандартным запросом chat-completions к этому хосту, с ID модели из пикера, путешествующим как строка. Chatbox неважно, какой вендор обучил модель за ID, — именно это и делает мультивендорный шлюз полезным здесь: одна запись провайдера помещает claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash и deepseek-v4-flash в один пикер, тарифицируемые через один ключ. Практическая разница со стопкой из четырёх фирменных провайдеров — не просто меньше ключей. Настройки Chatbox синхронизируются по устройствам, так что каждый добавленный вендорский аккаунт — это ещё один ключ, который нужно вставить на телефон, ноутбук и веб-приложение. Один кастомный провайдер — это одна вставка на устройство, а переключение разговора с Claude на DeepSeek — смена в пикере, а не смена провайдера.

Полная настройка: каждое поле диалога.

Name — просто подпись; APIsRouter держит пикер читаемым. API Mode должен быть OpenAI API Compatible, что говорит Chatbox использовать стандартные chat completions; другой режим в выпадающем списке — для нативных эндпоинтов Gemini и не то, что нужно шлюзу. API Host и API Path складываются в URL запроса, и именно эта пара — место, где настройки чаще всего ломаются. При хосте, установленном в https://api.apisrouter.com/v1, путь — /chat/completions, и Chatbox заполняет ровно это, когда распознаёт хост /v1. Документация Chatbox также описывает конвенцию с голым хостом, где хост опускает /v1, а путь по умолчанию — /v1/chat/completions; оба варианта складываются в один и тот же URL, так что выберите одну форму и оставьте второе поле на значении по умолчанию. Ломается смешивание — хост /v1 с путём /v1/chat/completions, что даёт удвоенный URL /v1/v1 с 404. Подписи полей и поведение автозаполнения немного меняются между релизами Chatbox, так что доверяйте составленному URL, а не памяти. Для моделей Fetch — путь наименьших усилий: Chatbox перечисляет всё, что обслуживает эндпоинт, и вы включаете нужное. New — курируемый путь: вводите ID вручную, и пикер остаётся коротким. У каждой строки модели есть переключатели возможностей (зрение, использование инструментов); оставляйте их выключенными, если не уверены, что модель поддерживает возможность, поскольку ненастроенная модель по умолчанию безопасно работает как обычный текстовый чат. Завершите проверкой Check, затем начните разговор и выберите модель под именем вашего нового провайдера.

Name:      APIsRouter
API Mode:  OpenAI API Compatible
API Key:   sk-YOUR-APISROUTER-KEY
API Host:  https://api.apisrouter.com/v1
API Path:  /chat/completions   (autofilled)

Models: Fetch (pull the catalog) or New (type ids)
Then:   Check → green confirmation

Выбор моделей для ежедневного чат-клиента.

Поскольку каждая включённая модель тарифицируется через один ключ, сравнение двух ID — это переключение в пикере, а не решение об аккаунте. Проведите похожие разговоры на обоих несколько дней, затем прочитайте расходы по модели в консоли APIsRouter и оставьте то, что оправдало своё место.

  • Повседневные вопросы и быстрые переписывания — это всплесковая работа. claude-haiku-4-5-20251001 и gemini-3.5-flash отвечают достаточно быстро, чтобы приложение ощущалось мгновенным, и хорошо несут большую часть ежедневного трафика.
  • Длинное написание, внимательный reasoning и обсуждения кода заслуживают claude-sonnet-4-6 или gpt-5.5. Держите включённым по одному из каждого тира и переключайтесь на разговор, а не на провайдера.
  • deepseek-v4-flash — выбор для объёма, если Chatbox — ваша постоянно открытая боковая панель; постоянные небольшие разговоры складываются, а быстрый тир держит расход баланса медленным.
  • Разговорам с вводом изображений нужен ID с поддержкой зрения и включённым переключателем зрения на этой строке модели; подтвердите возможность по документации модели, прежде чем переключать.
  • Включайте немного моделей осознанно, а не получая всё сразу: каждый переключатель — это строка в пикере, а добавление ещё одного ID позже — правка на десять секунд.

Оплата по факту · дешевле официальных цен

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

МодельОфициальная ценаНаша цена
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
Gemini 3.5 Flash$1.50 / $9.00 per M$1.20 / $7.20 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M

Сбои, специфичные именно для Chatbox.

Удвоенный путь — классика. 404 на каждом сообщении означает, что API Host и API Path вместе несут /v1, либо путь повторяет то, чем уже заканчивается хост; откройте запись провайдера и прочитайте эти два поля как один URL. Пустой результат от Fetch обычно означает, что ключ неверен или отсутствует, поскольку сам листинг моделей — это аутентифицированный запрос. Проверьте поле API Key и используйте кнопку Check, которая напрямую показывает ошибки аутентификации. Модель, выдающая ошибку только в некоторых разговорах, обычно связана с переключателем возможностей: зрение включено на модели без ввода изображений, либо поток, зависящий от инструментов, натыкается на модель с выключенными инструментами. Сбросьте строку модели к умолчаниям и включайте возможности по одной. И помните, что запись провайдера живёт на каждой установке отдельно. Добавление APIsRouter на десктопе не настраивает телефон; повторите диалог там же, либо используйте собственный обмен конфигами Chatbox, если ваша версия его предлагает. Единственное, что никогда не нужно повторять, — это регистрация у вендоров, поскольку один ключ покрывает каждую модель на каждом устройстве.

Кто направляет Chatbox через шлюз.

  • Люди, желающие видеть Claude, GPT, Gemini и DeepSeek в одном пикере, не поддерживая четыре вендорских аккаунта и четыре ключа на трёх устройствах.
  • Пользователи в регионах, где регистрация у некоторых вендоров болезненна; доступ на основе пополнения без требования карты убирает зависимость от каждого провайдера.
  • Разработчики, уже направляющие свой редактор и терминальные инструменты через шлюз и желающие видеть свой чат-клиент на том же ключе и том же логе использования.
  • Покупатели моделей, сравнивающие ID на реальных разговорах перед тем, как закрепить проект за одной из них; каждый кандидат — строка в пикере, а не аккаунт.
  • Домохозяйства и небольшие команды, стандартизирующие один эндпоинт, один баланс и видимость использования по ключу вместо разбросанных подписок.

Проверьте эндпоинт и отладьте первое сообщение.

Сначала подтвердите половину со стороны шлюза вне Chatbox: получите список моделей своим ключом, затем выполните один chat completion против ID, который планируете включить. Если оба проходят, всё оставшееся — в диалоге провайдера. Внутри Chatbox кнопка Check — самый быстрый сигнал. Ошибки аутентификации — это поле ключа. Ошибки not-found при отправке — это несовпадение ID, что чаще всего случается с записями, введёнными вручную через New; копируйте ID из вывода /v1/models, а не по памяти. 404 на каждом запросе — это составление хоста/пути, разобранное выше. Как только сообщения пойдут, консоль APIsRouter покажет модель на запрос, счётчики токенов и расходы. Чат-клиент генерирует много небольших запросов в течение дня, и лог использования — это то место, где эта привычка становится числом по модели, по дню, которое можно реально прочитать.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Частые вопросы

Как добавить кастомный API-хост в Chatbox?

Settings, вкладка Model Provider, Add, затем Add Custom Provider. Задайте API Mode как OpenAI API Compatible, API Host как https://api.apisrouter.com/v1, вставьте свой ключ и оставьте API Path на значении по умолчанию /chat/completions. Добавьте модели через Fetch или New, затем нажмите Check.

Должен ли API Host включать /v1?

Работает любая форма, если хост и путь вместе складываются ровно в /v1/chat/completions один раз. При хосте https://api.apisrouter.com/v1 путь — /chat/completions; при голом хосте путь по умолчанию — /v1/chat/completions. Смешивание обоих удваивает /v1 и даёт 404.

Может ли Chatbox запускать Claude, Gemini и DeepSeek через одну запись провайдера?

Да. В режиме OpenAI API Compatible ID модели путешествует к API Host как простая строка, так что одна запись может включить claude-sonnet-4-6, gemini-3.5-flash и deepseek-v4-flash вместе, все тарифицируются через один ключ и переключаемы в пикере.

Почему Fetch не возвращает моделей?

Fetch вызывает листинг /v1/models эндпоинта с вашим ключом, так что пустой результат почти всегда означает проблему аутентификации. Перепроверьте поле API Key и запустите кнопку Check; как только ключ проходит, Fetch перечисляет каждый ID, который обслуживает шлюз.

Работает ли кастомный провайдер и на мобильном, и в вебе Chatbox?

Да, диалог Add Custom Provider поставляется в десктопной, мобильной и веб-сборках. Записи провайдера настраиваются на каждую установку отдельно, так что повторите настройку в один диалог на каждом устройстве с тем же ключом.

Нужны ли переключатели возможностей на каждой модели?

Нет. Ненастроенная модель работает как обычный текстовый чат, что и является безопасным значением по умолчанию. Включайте переключатели зрения или инструментов только на моделях, которые реально поддерживают возможность, поскольку неверно включённый переключатель даёт запутанные ошибки именно в тех разговорах, где эта возможность используется.