Chatbox — кроссплатформенный ИИ-клиент для компьютера и мобильных устройств. Можно пользоваться встроенным сервисом Chatbox AI, а можно подключить собственный API-ключ и свои модели. Здесь речь только о втором варианте: от установки до подключения OpenAI-совместимого провайдера, проверки, синхронизации и командной настройки.

Примечание: Chatbox — товарный знак её правообладателя. Материал носит технический характер и не означает подчинения или сотрудничества с командой Chatbox. Названия пунктов меню и входы зависят от текущей версии; модели и цены — на странице цены на модели.

1. Установка: сначала платформа и версия

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

При установке обратите внимание на три вещи:

  1. Скачивайте из доверенного источника, перед установкой проверьте название приложения и разработчика.
  2. На корпоративном компьютере заранее уточните белый список программ, чтобы после установки не остаться без сети.
  3. После установки обновитесь до актуальной стабильной версии и только потом начинайте настройку.

В старых версиях может не быть «собственного поставщика моделей» или поля называются иначе. Если заполнять их по старой инструкции, ключ легко попадёт не в то поле. Сначала обновитесь, затем сверяйтесь с интерфейсом.

2. Три параметра перед подключением

Для любого шлюза собственному провайдеру нужны три вещи:

Параметр Пример Частая ошибка
API-ключ sk-... Пробел или перевод строки при копировании
Base URL https://ai.zhongshangqihang.com/v1 Указан полный адрес интерфейса
ID модели По странице цен Указано отображаемое имя вместо API-идентификатора

Ключ создаётся после регистрации в ZSQH AI Gateway; назовите его по устройству и назначению, например chatbox-mac-work. Base URL — это OpenAI-совместимый адрес шлюза. ID модели скопируйте со страницы цены на модели, следя за регистром, суффиксом версии и дефисами.

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

3. Добавление OpenAI-совместимого провайдера

Текст кнопок в версиях различается, но последовательность примерно одинаковая:

  1. Откройте Chatbox и перейдите в «Настройки».
  2. Найдите «Поставщики моделей» или «Модельные сервисы».
  3. Нажмите «Добавить» или «+», чтобы создать провайдера.
  4. В названии укажите что-то узнаваемое, например «ZSQH».
  5. В режиме API выберите OpenAI-совместимый, а не Anthropic или Gemini.
  6. Впишите API-ключ и Base URL.
  7. Нажмите «Получить», чтобы загрузить список моделей; если не вышло, добавьте ID вручную.
  8. Нажмите «Проверить», чтобы протестировать соединение, и выберите только что добавленную модель.

Под одним провайдером можно хранить несколько моделей. Диалоговые, визуальные и reasoning-модели удобно держать вместе, чтобы не ошибиться при переключении. Если есть тестовая и продуктивная среда, создайте двух провайдеров и различите их префиксом.

4. Как заполнять Base URL и ID модели

Base URL — самый частый источник ошибок. Его нужно указывать до /v1; остальной путь клиент добавляет сам. Если вписать туда ещё и /chat/completions, клиент может добавить путь повторно, и получится 404.

Правило запоминается двумя фразами:

  • 401 — сначала ключ: не истёк ли, не удалён ли, нет ли пробелов по краям.
  • 404 — сначала путь: попробуйте добавить или убрать /v1, меняя за раз только одну переменную.

ID модели должен точно совпадать с API-идентификатором на странице цен. Отображаемое имя обычно красивее, но для запроса не годится. Модели с датой, номером версии или суффиксом вроде -mini проверяйте посимвольно.

5. Проверка: сначала curl, потом клиент

Сначала проверьте шлюз в терминале — это исключает половину проблем:

export ZSQH_API_KEY="sk-ваш-ключ"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $ZSQH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ваш-ID-модели",
    "messages": [{"role": "user", "content": "Ответь только OK"}]
  }'

Если в JSON есть choices, ключ, адрес и модель верны. Затем выполните три проверки в клиенте:

  1. Отправьте короткий вопрос и убедитесь, что первый символ приходит нормально.
  2. Задайте два уточняющих вопроса подряд и проверьте, что контекст не потерялся.
  3. Попросите длинный ответ и убедитесь, что он не обрывается на середине.

Если обрывается только длинный ответ, проверяйте сеть и потоковый вывод; если падают все запросы — возвращайтесь к ключу и Base URL. Успешная кнопка «Проверить» подтверждает только базовую связность, а не все возможности.

6. Настройки и синхронизация: компьютер и телефон

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

Сценарий Что делать На что обратить внимание
Ежедневная работа на компьютере Сохранить провайдера, зафиксировать модель по умолчанию Регулярно экспортировать сессии
Короткие вопросы с телефона Отдельный провайдер, минимум моделей Не хранить ключ на общем телефоне постоянно
Смена компьютера Заново вписать ключ и ID моделей Не копировать весь каталог настроек
Общее устройство Отдельные системные учётные записи Чтобы сессии и ключи не были видны всем

Поддержка облачной синхронизации и её состав зависят от версии и способа входа; смотрите раздел данных в приложении. Не исходите из того, что «история синхронизируется вместе с ключом». Обычно ключ относится к локальной конфигурации и на новом устройстве его нужно вводить заново; экспортированная копия тоже может содержать чувствительные данные и требует обращения как с ключевым файлом.

7. Командная работа: конфигурация как инфраструктура

В небольших командах чаще страдает не подключение, а передача дел. Минимальный набор правил:

  • Выдавайте ключ каждому человеку, а не один на всех.
  • Используйте единый формат названий провайдеров, например с префиксом ZSQH-.
  • Настройте на шлюзе бюджет или напоминания о расходе, чтобы не тратить токены в фоне.
  • При увольнении или потере устройства сначала отзывайте ключ, потом занимайтесь остальными учётными записями.
  • Запишите Base URL, ID моделей и версию клиента во внутреннюю документацию.

Смысл не в «формальной дисциплине», а в скорости диагностики: чей ключ перестал работать, какая модель снята, у кого версия клиента отличается.

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

Можно ли пользоваться Chatbox без API-ключа?

Можно пользоваться встроенным сервисом Chatbox AI; лимиты и условия оплаты определяются текущей версией. Режим со своим ключом работает через выбранного поставщика API, и расход считает поставщик — это разные вещи.

Нужен ли /v1 в Base URL?

Большинству OpenAI-совместимых конфигураций он нужен. Если ошибка возникает и с ним, и без него, найдите через curl полный адрес, который возвращает результат, и перенесите его в клиент — не угадывайте.

Если «Получить список моделей» не работает, ключ сломан?

Не обязательно. Возможно, шлюз не открывает интерфейс списка моделей или путь неверен. Добавьте ID вручную и проверьте кнопкой «Проверить» или реальным диалогом. Если вручную работает, значит, не поддерживается только список.

На компьютере работает, а на телефоне нет?

Сначала убедитесь, что на обоих устройствах одинаковые Base URL и ID модели, затем проверьте, не блокирует ли мобильная сеть запросы. Вход и доступные функции мобильной версии могут отличаться; не храните на телефоне ключ с широкими правами постоянно.

Сохранится ли конфигурация после смены компьютера?

История и настройки сохраняются в зависимости от входа в учётную запись, синхронизации и экспортированных копий. Ключ лучше ввести заново, а ключ на старом устройстве отозвать, как только оно перестанет использоваться.

Дальше

В подключении Chatbox к собственному API важны три шага: правильная версия, верный Base URL и точный ID модели. Сначала проверьте через curl, потом переходите в клиент; при ошибках действуйте по порядку: 401 — ключ, 404 — путь, «модель не найдена» — ID. Если нужны единая точка входа и управление расходом, можно зарегистрироваться в ZSQH AI Gateway; модели и цены — на странице цены на модели.

Полезное чтение: