Подключить Cherry Studio к CheapTokens: свой провайдер и Base URL

Чтобы работать с CheapTokens в Cherry Studio, добавьте свой провайдер (Settings → Model Provider → Add Provider), впишите в поле OpenAI Base URL адрес https://api.cheaptokens.dev/v1/, вставьте API-ключ и вручную добавьте id модели deepseek-ai/DeepSeek-V4-Flash-0731. Затем проверьте ключ кнопкой Model Check и напишите «привет». Это вся настройка; подводит только слеш в конце адреса.

Десктопный чат открывают ради одного окна для нескольких моделей и одного баланса за ними, а не ради вкладки браузера на каждый сервис. Cherry Studio для этого и сделан: это открытая AI-рабочая станция для Windows, macOS и Linux (Community Edition под AGPL-3.0) с чатом, агентами и базами знаний, а любой OpenAI-совместимый сервис подключается как свой провайдер. CheapTokens работает в формате OpenAI Chat Completions, так что подходит. Шаги ниже следуют странице документации Cherry Studio о своих провайдерах, проверено 7 ноября 2026; приложение меняется, и если подпись сдвинулась, ищите то же слово рядом.

Что приготовить до открытия приложения#

Три вещи, все короткие:

• Base URL: https://api.cheaptokens.dev/v1/ (со слешем на конце — почему, объяснено ниже);
• API-ключ из вашего аккаунта CheapTokens, лежащий там, откуда его удобно копировать, а не в общей заметке;
• полный id модели. Короткое имя из прайса API не принимает; берите id шлюза, например deepseek-ai/DeepSeek-V4-Flash-0731. Остальные id — в статье про список моделей и в документации CheapTokens.

Добавляем свой провайдер#

Откройте Settings (значок шестерёнки), затем Model Provider. Внизу списка провайдеров — + Add Provider. Нажмите, и откроется диалог Add Custom Provider.

Заполните так:

По умолчанию Cherry Studio показывает поля для «OpenAI» и «Anthropic». Заполняйте только тот протокол, которым пользуетесь; для обычного чата это OpenAI, а поле Anthropic можно оставить пустым. Под каждым полем Base URL приложение показывает предпросмотр итогового пути запроса. Читайте его: это самый быстрый способ заметить неверный адрес до первого сообщения.

Нажмите Add, чтобы сохранить.

Зачем слеш в конце#

Cherry Studio собирает адрес запроса из Base URL по трём правилам из своей документации (проверено 7 ноября 2026):

• корневой адрес вроде https://example.com получает добавку /v1/chat/completions;
• адрес, заканчивающийся на /, получает только chat/completions;
• адрес, заканчивающийся на #, используется как написан, без добавок.

CheapTokens живёт под /v1, поэтому https://api.cheaptokens.dev/v1/ превращается в https://api.cheaptokens.dev/v1/chat/completions — тот путь, который ждёт API. Предпросмотр под полем должен читаться именно так. Если видите /v1/v1/ или вообще нет /v1, поправьте поле, прежде чем идти дальше.

Ключ, модель и Model Check#

На странице провайдера пять небольших шагов. Делайте их по порядку:

Про шаг 5. На странице есть кнопка Sync models, она подтягивает список моделей у сервиса. Надёжный путь — добавить id самому через +: впишите deepseek-ai/DeepSeek-V4-Flash-0731 точно, вместе с deepseek-ai/. Какие модели можно добавить:

Model Check — кнопка рядом с полем ключа; по документации Cherry Studio она проверяет, что ключ действителен. Если она ругается, переходите к разделу об ошибках ниже: обычно виновато одно из трёх полей.

Первое сообщение#

Откройте новый чат, выберите провайдера CheapTokens и добавленную модель в селекторе вверху и напишите что-нибудь короткое, например «Объясни в двух предложениях, что такое токен». Ответ модели значит, что вся цепочка работает: ключ, адрес, id модели.

Хотите увидеть запрос без приложения? Вот обычный вызов Chat Completions:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

Ответ — JSON: текст лежит в choices[0].message.content, счётчики токенов — в usage.

Какую модель поставить в десктопный чат#

Окно чата — не то же самое, что цикл агента: вы спрашиваете, читаете, спрашиваете снова. Тогда важны две вещи: какой длины бывают ответы и какой разговор помещается.

• DeepSeek-V4-Flash — выбор по умолчанию для обычного чата и длинных документов: до 32 768 токенов в ответе, контекст 380K, одна цена в любое время суток. В сумме, с учётом входа и выхода, дешевле OpenRouter.
• GLM-5.3-Flash — повседневный чат с самым большим окном из трёх (390K), дешевле OpenRouter и по входу, и по выходу.
• MiniMax-M2.7 — чат и задачи в духе агента с контекстом 180K, дешевле OpenRouter с обеих сторон.

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

Сколько стоит сессия в чате#

Примерная картина. Допустим, у вас разговор на 20 сообщений. Каждое сообщение пересылает прежнюю историю, поэтому запрос в среднем — около 6 000 токенов на входе и 500 на выходе (почему так, разобрано в статье почему длинный чат дороже). Один запрос на DeepSeek-V4-Flash стоит $0.00014. Двадцать таких — в калькуляторе ниже; подвигайте ползунки под свои разговоры.

Та же сессия на всех моделях в таблице, с колонкой OpenRouter для сравнения:

Актуальные цены за 1M токенов — на странице цен CheapTokens.

Если не работает#

Большинство проблем растёт из трёх одних и тех же полей: ключ, адрес, id модели. Сопоставьте то, что видите, с причиной:

Подробнее об этих ошибках — в статье API 401 или 404: ключ, base URL или id модели. А если вам больше по душе чат в браузере, а не десктопное приложение, Open WebUI подключается так же.

Источники: документация Cherry Studio, страницы о своих провайдерах и настройках провайдеров, проверено 7 ноября 2026; проект — github.com/CherryHQ/cherry-studio.