Cherry Studio — бесплатный десктопный клиент для языковых моделей с открытым исходным кодом (лицензия AGPL-3.0) для Windows, macOS и Linux. В одном окне — чат с несколькими моделями, ассистенты, база знаний по вашим документам, распознавание картинок и MCP-серверы. Своих моделей у Cherry Studio нет: он работает через API тех провайдеров, которые вы в нём настроите.
В России с этим проблема: зарубежные API не принимают российские карты, а часть из них не отвечает на запросы из РФ. Решение — подключить Cherry Studio к OpenAI-совместимому API PlusVibe: один ключ, модели Claude, GPT, DeepSeek, Gemini и другие, оплата в рублях. Ниже — пошаговая настройка, проверенная на нашем API теми же запросами, которые отправляет Cherry Studio. Инструкция написана по версии 2.1.6 (релиз 11 октября 2026 года).
Что понадобится
- Cherry Studio — установщик берётся на официальном сайте cherryai.com или в релизах на GitHub.
- Ключ PlusVibe. Зарегистрируйтесь на plusvibeapi.ru/register и создайте ключ в разделе «API-ключи». Ключ выглядит как
sk-pv-…. Для Cherry Studio удобно завести отдельный ключ с лимитом расхода — так в статистике видно, сколько потратил именно этот клиент.
Шаг 1. Добавьте провайдера
Откройте Настройки → Провайдеры моделей и нажмите «Добавить провайдера». В окне создания пользовательского провайдера:
- Имя провайдера — любое, например
PlusVibe. - В настройках конечной точки заполните поле для формата OpenAI (Chat Completions) — это основной формат нашего API, он подходит для всех текстовых моделей каталога. Остальные форматы заполнять не нужно.
- В поле адреса укажите корень API:
Хост API: https://plusvibeapi.ru
Ключ API: sk-pv-ВАШ_КЛЮЧПод полем Cherry Studio показывает строку «Путь запроса» — там должно получиться https://plusvibeapi.ru/v1/chat/completions.
С /v1 или без: как Cherry Studio собирает адрес
Это самая частая причина ошибок, поэтому коротко о правилах. Мы проверили их по исходному коду Cherry Studio (функция formatApiHost, одинаковая в версиях 1.9 и 2.1):
- Если в адресе нет версии API, Cherry Studio сам добавляет
/v1:https://plusvibeapi.ruпревращается вhttps://plusvibeapi.ru/v1. - Если версия уже есть, второй раз она не добавляется:
https://plusvibeapi.ru/v1тоже работает. - Косая черта в конце отбрасывается:
https://plusvibeapi.ru/— то же самое, что без неё. - Символ
#в конце отключает автоматическое добавление версии — Cherry Studio использует адрес как есть. Для нашего API этот приём не нужен. Если всё же им пользуетесь, пишитеhttps://plusvibeapi.ru/v1#: вариантhttps://plusvibeapi.ru#отправит запросы на адрес без/v1, и чат ответит ошибкой 404.
Итог: пишите https://plusvibeapi.ru или https://plusvibeapi.ru/v1 — оба варианта дают правильный путь.
Шаг 2. Получите список моделей
После сохранения ключа Cherry Studio запрашивает у API список моделей — это обычный GET /v1/models с заголовком Authorization: Bearer. Отметьте нужные модели и нажмите «Проверить и включить»: Cherry Studio отправит пробный запрос к выбранной модели и включит провайдера.
Тот же запрос можно повторить вручную, чтобы убедиться, что ключ работает:
curl -s https://plusvibeapi.ru/v1/models \
-H "Authorization: Bearer sk-pv-ВАШ_КЛЮЧ" | jq -r '.data[].id'В ответе — идентификаторы всех моделей каталога, текстовых и для эмбеддингов. Вот как выглядят строки для моделей из этой статьи (вывод отфильтрован):
claude-sonnet-5.5
gpt-6-luna
deepseek-v4.1-flash
google/gemini-3.8-flash
bge-m3Добавить модель вручную
Если модель не нужна из общего списка или вы хотите задать ей параметры, нажмите «Добавить модель вручную» и введите ID модели ровно так, как он написан в каталоге и в ответе /v1/models, — например claude-sonnet-5.5 или google/gemini-3.8-flash. Поле «Имя модели» — только подпись в интерфейсе, его можно сделать любым. В том же окне задаются возможности модели (визуальные, рассуждение, инструменты, эмбеддинги) — если Cherry Studio не распознал модель сам, отметьте нужное вручную, иначе соответствующие функции в чате не появятся.
Для начала подойдёт такой набор:
gpt-6-luna— быстрые повседневные вопросы, понимает изображения;claude-sonnet-5.5— тексты, анализ документов и код;deepseek-v4.1-flash— самая дешёвая из этого списка;google/gemini-3.8-flash— работа с изображениями и длинными материалами.
| Модель | Вход | Выход |
|---|---|---|
| gpt-6-luna | 3 ₽/1M | 19,07 ₽/1M |
| claude-sonnet-5.5 | 59 ₽/1M | 294 ₽/1M |
| deepseek-v4.1-flash | 1,91 ₽/1M | 7,63 ₽/1M |
| gemini-3.8-flash | 4,72 ₽/1M | 23,58 ₽/1M |
Цены — за 1 млн токенов, из живого каталога; все модели — на странице /models. Подробнее про отдельные семейства — в статьях про Claude API в России и ChatGPT в России.
Шаг 3. Проверьте чат
Создайте новый чат, выберите модель из группы провайдера PlusVibe и задайте вопрос. Cherry Studio отправляет потоковый запрос к /v1/chat/completions. Ниже — тот же запрос через curl; мы выполнили его на боевом API перед публикацией:
curl -sN https://plusvibeapi.ru/v1/chat/completions \
-H "Authorization: Bearer sk-pv-ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-luna",
"stream": true,
"stream_options": {"include_usage": true},
"reasoning_effort": "low",
"messages": [{"role": "user", "content": "Одной фразой: зачем нужен десктопный клиент для LLM?"}]
}' | tail -n 6Конец потока — последний фрагмент с расходом токенов и маркер завершения:
data: {"choices":[{"delta":{},"finish_reason":"stop","index":0}],...,"model":"gpt-6-luna","object":"chat.completion.chunk","usage":{"completion_tokens":41,"prompt_tokens":33,"total_tokens":74}}
data: {"choices":[],"object":"chat.completion.chunk","usage":{"completion_tokens":41,"prompt_tokens":33,"total_tokens":74}}
data: [DONE]Фрагмент с usage Cherry Studio использует, чтобы показать под ответом количество токенов.
Рассуждения, изображения и инструменты
Уровень размышлений
Для моделей с рассуждением в настройках ассистента и в панели ввода появляется переключатель «Уровень размышлений»: «По умолчанию», «Выключить», «Низкий», «Средний», «Высокий» и другие — набор зависит от модели. Для OpenAI-совместимого провайдера Cherry Studio передаёт выбор в параметре reasoning_effort; наш API его принимает, что видно по примеру выше. Токены рассуждения оплачиваются как выходные, поэтому для простых вопросов разумно ставить низкий уровень. Какие уровни поддерживает каждая модель — в разделе документации «Режим рассуждений».
Если переключатель не появился, откройте настройки модели и отметьте у неё возможность «Рассуждение».
Изображения
Картинку можно вставить прямо в поле ввода. Cherry Studio отправит её в формате OpenAI — частью сообщения типа image_url с данными в base64. Мы проверили такой запрос с тестовым изображением, левая половина которого красная, а правая синяя: gpt-6-luna, claude-haiku-5.5 и google/gemini-3.8-flash ответили одинаково — «слева красный, справа синий». Если кнопка прикрепления картинки неактивна, у модели в Cherry Studio не отмечена возможность «Визуальные». Какие модели принимают изображения, видно в каталоге.
MCP-серверы
В разделе Настройки → Серверы MCP подключаются встроенные серверы (чтение веб-страниц, файловая система, память и другие) или свои — через STDIO, SSE или Streamable HTTP. Сами MCP-серверы работают на вашем компьютере или у их владельца, а модель получает их инструменты обычным полем tools в запросе и решает, какой вызвать. Поэтому для MCP нужна модель с поддержкой вызова функций. Мы проверили такой запрос с инструментом получения веб-страницы на deepseek-v4.1-flash: модель вернула finish_reason: "tool_calls" и вызов с нужным URL. Подробнее о механизме — в статье про function calling.
База знаний: эмбеддинги через PlusVibe
База знаний в Cherry Studio — это поиск по вашим файлам, папкам, заметкам и веб-страницам: документы режутся на фрагменты, каждый превращается в вектор, а в чат подставляются самые близкие к вопросу. Для векторов нужна модель эмбеддингов, и её можно взять у того же провайдера PlusVibe.
- В списке моделей провайдера PlusVibe включите модель эмбеддингов, например
bge-m3илиqwen3-embedding-8b. Если Cherry Studio не отнёс модель к эмбеддингам сам, в её настройках выберите тип «Эмбеддинги». - Откройте База знаний → Новая база знаний и в поле «Модель эмбеддингов» выберите эту модель.
- Добавьте источники — файл, папку, URL или заметку — и дождитесь окончания индексации.
Размерность векторов Cherry Studio узнаёт сам: отправляет пробный запрос со словом test и считает длину ответа. Вот тот же запрос:
curl -s https://plusvibeapi.ru/v1/embeddings \
-H "Authorization: Bearer sk-pv-ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"model": "bge-m3", "input": "test"}' \
| jq '{model, dims: (.data[0].embedding | length), usage}'{
"model": "bge-m3",
"dims": 1024,
"usage": {
"prompt_tokens": 3,
"total_tokens": 3
}
}У qwen3-embedding-8b размерность 4096. Учтите: после смены модели эмбеддингов базу знаний приходится пересоздавать — векторы разных моделей несовместимы. Для документов на русском хорошо подходят bge-m3, frida и модели семейства Qwen3 Embedding:
| Модель | Вход | Выход |
|---|---|---|
| bge-m3 | 5 ₽/1M | 0 ₽/1M |
| qwen3-embedding-8b | 5 ₽/1M | 0 ₽/1M |
| frida | 4 ₽/1M | 0 ₽/1M |
Сравнение всех моделей эмбеддингов и примеры кода — в статье «Embeddings API в России».
Частые проблемы
401 — неверный ключ
API отвечает authentication_error с текстом «Отсутствует или неверный API-ключ». Ключ скопирован не полностью, с лишним пробелом, удалён или исчерпал лимит расхода. Проверьте его в разделе «API-ключи» и вставьте заново.
404 или «не удалось получить модели»
Почти всегда виноват адрес. Посмотрите строку «Путь запроса» в настройках провайдера: должно быть https://plusvibeapi.ru/v1/chat/completions. Если там нет /v1 — скорее всего, в конце адреса стоит #: уберите его или напишите https://plusvibeapi.ru/v1#. Без /v1 вместо API отвечают страницы сайта: чат получает 404, а список моделей — HTML-страницу вместо JSON.
«Модель не найдена»
API отвечает 404 с типом model_not_available, если ID модели не совпадает с каталогом, — например, вы добавили модель вручную с опечаткой или со старым названием. В тексте ошибки API подсказывает формат правильного идентификатора. Сверьте ID с ответом /v1/models или нажмите в Cherry Studio кнопку обновления списка моделей.
Нет кнопки картинки или переключателя рассуждений
Cherry Studio показывает эти элементы по возможностям модели. Откройте настройки модели в провайдере PlusVibe и отметьте «Визуальные» или «Рассуждение».
Cherry Studio или веб-интерфейс
Cherry Studio — личное приложение: всё хранится на компьютере, ставится за пару минут, сервер не нужен. Если чат нужен команде — с общими аккаунтами, доступом из браузера и хранением на вашем сервере, — посмотрите Open WebUI и LibreChat: они подключаются к тому же ключу PlusVibe.
Частые вопросы
Нужен ли VPN? Нет. Cherry Studio обращается напрямую к plusvibeapi.ru, а мы уже отправляем запрос к модели.
Какой тип провайдера выбирать? OpenAI-совместимый формат Chat Completions. Он работает для всех текстовых моделей каталога, включая Claude и Gemini, поэтому отдельные провайдеры под каждую компанию не нужны.
Писать адрес с /v1 или без? Подойдут оба варианта: https://plusvibeapi.ru и https://plusvibeapi.ru/v1. Cherry Studio сам добавит /v1, если его нет, и не продублирует, если он есть.
Сколько это стоит? Cherry Studio бесплатен. Платите только за токены по ценам каталога — без подписки и абонентской платы, с баланса в рублях. Цены всех моделей — на странице /models.
Можно ли использовать один ключ в нескольких программах? Да, но удобнее завести отдельный ключ на каждую программу: так в статистике видно расход каждой, а при утечке достаточно отозвать один ключ.
Итог
Cherry Studio подключается к PlusVibe за несколько минут: пользовательский провайдер в формате OpenAI, хост https://plusvibeapi.ru, ключ sk-pv-… и модели из автоматически загруженного списка. По тому же ключу работают база знаний на наших эмбеддингах, изображения, рассуждения и инструменты MCP — с оплатой в рублях и без VPN.
Подключите Cherry Studio к PlusVibe
Claude, GPT, DeepSeek, Gemini и другие модели по одному ключу. Оплата в рублях.
Получить ключ →
