Перейти к основному содержанию
Cherry Studio — кроссплатформенный десктопный AI-клиент с открытым кодом. Поддерживает несколько LLM-провайдеров одновременно, локальную базу знаний, агентов. RuAPI подключается через OpenAI-совместимый протокол.

Предварительные требования

1

Аккаунт RuAPI и API-ключ

Консоль → API-ключи → создайте ключ sk-....
Быстрее всего — взять готовые настройки из Консоли. Откройте Консоль → API-ключи, нажмите «Подключить Claude Code, Cline и др.» и выберите Cherry Studio. Кнопка «Добавить RuAPI в Cherry Studio» сама добавит провайдера RuAPI (если Cherry Studio запускается впервые, сначала нажмите «Пропустить» вверху справа на экране приветствия), а для ручной настройки там же есть поля с вашим ключом. Установите программу по шагам ниже и выполните шаги из окна (провайдер, модель deepseek-flash, проверка): в разделе «Добавление RuAPI как провайдера» останется только последний шаг — выбрать модели по умолчанию.
Страница API-ключей RuAPI: адрес https://www.ruapi.ai и кнопка «Подключить Claude Code, Cline и др.»

Консоль → API-ключи: кнопка «Подключить Claude Code, Cline и др.»

Окно «Подключить программу» в Консоли RuAPI с готовыми настройками для Cherry Studio

Окно «Подключить программу», выбран Cherry Studio: адрес и ключ уже подставлены (на скриншоте ключ скрыт)

Установка Cherry Studio

Скачайте с cherry-ai.com или со страницы релизов GitHub:
Скачайте Cherry-Studio-Setup-x.y.z.exe и запустите установщик.

Добавление RuAPI как провайдера

Инструкция и скриншоты — для Cherry Studio 2.1.6 (октябрь 2026). В других версиях названия кнопок могут немного отличаться.
1

Откройте добавление провайдера

При первом запуске Cherry Studio нажмите «Настроить другого провайдера», затем «Добавить провайдера» внизу списка.Если Cherry Studio уже настроен: Настройки → «Провайдеры моделей» → «Добавить провайдера».
2

Заполните форму

Под адресом Cherry Studio покажет путь запроса https://www.ruapi.ai/v1/chat/completions — значит, адрес указан верно. Поле Anthropic можно оставить пустым. Нажмите «Добавить».
Cherry Studio: форма добавления провайдера RuAPI с адресом https://www.ruapi.ai

Форма нового провайдера: имя, ключ и адрес OpenAI

3

Добавьте модель deepseek-flash

Cherry Studio откроет список моделей RuAPI — нажмите в нём «Пропустить». Затем нажмите «+» справа от «Синхронизировать модели», в поле «ID модели» введите deepseek-flash (поля «Имя модели» и «Имя группы» заполнятся сами) и нажмите «Добавить модель».
Если вы ещё не пополняли баланс, пробные $0,05 (их начисляют новым пользователям при регистрации) работают только с deepseek-flash, claude-haiku-5-5 и gpt-6-luna. После пополнения от 5 $ остальные модели можно добавить кнопкой «Синхронизировать модели» — просто отметьте их в списке. Цены — на странице цен.
Cherry Studio: окно «Добавить модель», ID, имя и группа — deepseek-flash

Добавление модели: в поле «ID модели» — deepseek-flash

4

Проверьте и включите провайдера

Нажмите «Проверка моделей» справа от ключа API, а в открывшемся окне — «Начать». Когда проверка пройдёт, переключатель вверху справа станет зелёным — провайдер включён.
Cherry Studio: окно проверки, выбрана deepseek-flash, кнопка «Начать»

Проверка deepseek-flash

На странице провайдера видны ключ, адрес и модель deepseek-flash.
Cherry Studio: страница провайдера RuAPI с ключом, адресом и моделью deepseek-flash

Провайдер RuAPI настроен и включён

5

Выберите модели по умолчанию

При первом запуске нажмите «Далее» внизу справа — откроется экран «Выберите модели по умолчанию». В первом списке выберите deepseek-flash из группы RuAPI — два других поля заполнятся той же моделью. Нажмите «Начать».
Cherry Studio: модель ассистента, быстрая модель и модель перевода — deepseek-flash из RuAPI

Все три модели по умолчанию — deepseek-flash

Если после этого появится окно «Включить API Gateway?», нажмите «Отмена»: шлюз нужен только агентам Cherry Studio, а обычный чат работает и без него.

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

Откройте «Чат» (значок сообщения на левой панели), вверху нажмите на название модели и выберите модель из группы RuAPI. Отправьте:
Нормальный ответ + запись в Консоли RuAPI → Журнал запросов = всё работает.

Модели по умолчанию

Настройки → «Модель по умолчанию»:
  • Модель ассистента по умолчанию: для обычных диалогов. Рекомендуем семейство GPT или Claude Sonnet.
  • Быстрая модель: для простых задач — названия чатов, ключевые слова для поиска. Подойдёт дешёвая Claude Haiku.
  • Модель перевода: подойдут GPT mini или Claude Haiku.
Пока у вас пробный баланс, выберите в этих полях deepseek-flash из группы RuAPI: по умолчанию Cherry Studio использует свою встроенную модель, а не RuAPI.

Решение проблем

  • API-ключ должен быть ключом RuAPI (sk-...), а не ключом OpenAI.
  • Следите за пробелами в конце.
  • Проверьте состояние ключа в Консоли RuAPI → API-ключи.
  • Опечатка в ID. При ручном добавлении «ID модели» должен полностью совпадать с RuAPI (например, deepseek-flash), без пробелов в начале и в конце. Остальные модели проще добавить кнопкой «Синхронизировать модели», отметив их в списке.
  • Не добавляйте /chat/completions к API-адресу — достаточно https://www.ruapi.ai.
Стриминг (SSE) включён по умолчанию у обеих сторон. Если есть лаги:
  • Проверьте стабильность сети.
  • Попробуйте отключить стриминг в настройках и сравнить.
MCP в Cherry Studio опирается на function calling в модели. Уверенно с этим работают модели GPT и Claude — см. вызов функций.
Убедитесь, что выбранная модель умеет работать с изображениями. На RuAPI картинки понимают модели GPT, Claude, Gemini и deepseek-flash; модели GLM работают только с текстом — см. работу с изображениями.
Cherry Studio поддерживает сколько угодно провайдеров. Добавьте каждый по той же схеме. Переключатель в правом верхнем углу чата меняет провайдера и модель.

Продвинутое

  • База знаний: встроенному RAG в Cherry Studio нужна модель эмбеддингов. У RuAPI есть text-embedding-3-small и text-embedding-3-large: добавьте нужную в провайдер RuAPI кнопкой «+», как обычную модель (по ID; если Cherry Studio сам не определил тип, отметьте её как модель эмбеддингов), и выберите её при создании базы знаний. Модели эмбеддингов открываются после пополнения баланса. Если документы не должны уходить в облако, подключите локальную модель эмбеддингов (например, через Ollama), а чат оставьте на RuAPI.
  • Агенты: система агентов Cherry Studio полностью клиентская и вызывает настроенного провайдера. Семейства Claude Sonnet или GPT отлично подходят как «мозг» агента.
  • Несколько ключей: если одного ключа не хватает — создайте несколько в Консоли RuAPI со своими лимитами и распределите по разным профилям Cherry Studio.