Cherry Studio и BetterToken: пользовательский провайдер, API Host и модели
Добавьте BetterToken в Cherry Studio как пользовательский провайдер с протоколом OpenAI или Anthropic, укажите Model ID, проверьте подключение и устраните частые ошибки.
Чтобы подключить Cherry Studio к BetterToken, добавьте пользовательский провайдер, укажите BetterToken API Key и API Host, затем добавьте актуальный Model ID из каталога моделей.
Ключевые параметры
| Поле | Значение |
|---|---|
| Тип провайдера | OpenAI (OpenAI-compatible) |
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai (API Host) |
| Model | Актуальный Model ID из каталога моделей |
Подготовка
- Установленная актуальная версия Cherry Studio
- BetterToken API Key: зарегистрироваться и получить
- Model ID из каталога моделей
Уже есть аккаунт? Войдите, пополните баланс и создайте ключ в консоли.
Установка
Скачайте Cherry Studio для своей системы с официального сайта или из GitHub Releases, установите и запустите. Дополнительные плагины не нужны.
Ручная настройка
Настройка выполняется в интерфейсе Cherry Studio. Редактировать конфигурационный файл не требуется.
Добавьте пользовательский провайдер
Откройте Settings → Model Provider, нажмите Add, укажите имя, например BetterToken, и выберите тип OpenAI.
Укажите API Key и API Host
- API Key → ваш BetterToken API Key
- API Host →
https://bettertoken.ai
Cherry Studio сам добавляет путь запроса. Проверьте предпросмотр адреса под полем: он должен быть https://bettertoken.ai/v1/chat/completions. Не вставляйте полный адрес с /chat/completions в API Host.
Добавьте модели
Нажмите Manage, чтобы загрузить список моделей, или Add, чтобы указать Model ID вручную, например claude-sonnet-5-5, gpt-6-sol или deepseek-flash.
Проверьте подключение
Нажмите Check, выберите одну из добавленных моделей и дождитесь сообщения об успехе. Затем включите провайдер.
Протокол Anthropic
Для моделей Claude можно добавить второй пользовательский провайдер с типом Anthropic и API Host https://bettertoken.ai. Тогда Cherry Studio отправляет запросы на /v1/messages. Используйте этот провайдер только для моделей Claude. Для остальных моделей используйте провайдер типа OpenAI.
Проверка подключения
Откройте новый диалог, выберите модель BetterToken и отправьте Ответь одним словом: OK. Обычный ответ означает, что настройка работает.
Смена модели
Выберите другую модель BetterToken в селекторе модели диалога. Если нужной модели ещё нет в списке, откройте провайдер BetterToken, нажмите Add и введите точный Model ID из каталога моделей.
Частые ошибки
| Ошибка | Что проверить |
|---|---|
401 или Unauthorized | Проверьте BetterToken API Key и удалите пробелы в начале и конце. |
404 | API Host должен быть https://bettertoken.ai, а в предпросмотре /v1/chat/completions должен встречаться один раз. |
model not found | Скопируйте актуальный Model ID из каталога моделей. |
| Пустой список моделей | Добавьте Model ID вручную кнопкой Add. |
Расширенная настройка
Связанные руководства
Технические детали
Протокол и endpoint
Тип провайдера OpenAI отправляет запросы на https://bettertoken.ai/v1/chat/completions. Тип провайдера Anthropic отправляет запросы на https://bettertoken.ai/v1/messages. В обоих случаях в API Host указывайте только https://bettertoken.ai.

