Добавьте каждую модель каталога в 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 поставляется в десктопной, мобильной и веб-сборках. Записи провайдера настраиваются на каждую установку отдельно, так что повторите настройку в один диалог на каждом устройстве с тем же ключом.
Нужны ли переключатели возможностей на каждой модели?
Нет. Ненастроенная модель работает как обычный текстовый чат, что и является безопасным значением по умолчанию. Включайте переключатели зрения или инструментов только на моделях, которые реально поддерживают возможность, поскольку неверно включённый переключатель даёт запутанные ошибки именно в тех разговорах, где эта возможность используется.