Как подключить Cherry Studio к Tokenator API

Что получится в итоге

После настройки Cherry Studio перестаёт обращаться к своему стандартному провайдеру и отправляет все запросы в Tokenator. Оплата идёт токенами вашего ключа, а список доступных моделей задаётся ключом, а не инструментом.

Требования и поддерживаемые ОС

• Windows 10/11, macOS 12+ или современный Linux с 64-битной архитектурой.
• Доступ в интернет к домену Tokenator по HTTPS.
• API-ключ Tokenator вида sk-your-tokenator-key.

Нужна десктопная сборка Cherry Studio. Node.js, редактор и аккаунт в самом клиенте не требуются — настройка целиком в интерфейсе.

Установка Cherry Studio

Скачайте сборку для своей системы с официального сайта проекта и установите её обычным способом. Регистрация в Cherry Studio не нужна: клиент хранит настройки локально и работает на вашем ключе.

Настройка Tokenator

1. Зарегистрируйтесь в личном кабинете и купите пакет токенов.
2. Ключ появится в кабинете сразу после подтверждения оплаты — копировать его нужно целиком, вместе с префиксом.
3. В примерах ниже вместо настоящего ключа стоит плейсхолдер sk-your-tokenator-key. Не публикуйте настоящий ключ в репозиториях и скриншотах.

Конфигурация

1. Откройте Настройки (шестерёнка в левом нижнем углу) и перейдите в раздел Поставщики моделей.
2. Прокрутите список поставщиков вниз и нажмите + Добавить.
3. Тип поставщика: OpenAI. Имя — любое, например Tokenator.
4. Ключ API: sk-your-tokenator-key
5. Адрес API: https://api.tokenator.top/v1/ — именно с косой чертой на конце.
6. В блоке Модели нажмите + Добавить и вставьте ID модели, например gpt-5.5. Повторите для каждой нужной модели.
7. Включите тумблер поставщика в списке слева и сохраните.

Первый запрос

Перед запуском инструмента полезно убедиться, что ключ и модель рабочие. Один запрос curl отвечает на оба вопроса сразу.

curl https://api.tokenator.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-tokenator-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "ping"}]
  }'

Рядом с полем ключа в карточке поставщика есть кнопка Проверить — она отправляет пробный запрос выбранной моделью. Успешная проверка означает, что ключ и адрес введены верно. После этого откройте новый чат и выберите модель в селекте наверху.

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

Переключение моделей

Модели добавляются вручную в карточке поставщика, в блоке Модели: клиент не запрашивает их список у сервера. ID вставляется ровно как в каталоге, без префиксов. Base URL и ключ при добавлении новой модели менять не нужно.

Примеры ID моделей, доступных сейчас:

• claude-haiku-4-5
• claude-opus-4-6
• claude-opus-4-7
• claude-sonnet-4-6
• gpt-5.5
• deepseek-v4-flash

Актуальные ID и характеристики — в каталоге AI-моделей; там же видно, какие модели сейчас доступны. Выбрать между близкими вариантами помогает сравнение моделей.

Настройка reasoning

Если инструмент умеет передавать поле reasoning_effort в запросе, Tokenator пробрасывает его в апстрим без изменений. Дополнительно у самого ключа есть переключатель reasoning в личном кабинете — он действует независимо от инструмента.

Частые ошибки и способы исправления

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

Читайте дальше