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

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

1

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

Консоль → API-ключи → создайте ключ sk-....

​
Установка Cherry Studio

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

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

1

Откройте «Настройки → Модели»

После запуска Cherry Studio нажмите ⚙️ в левом нижнем углу → Настройки → Сервисы моделей в левой панели.
2

Нажмите «Добавить»

Кнопка + Добавить внизу списка провайдеров.
3

Основная информация

Нажмите ОК.
4

API-ключ и адрес

В панели свойств RuAPI:
Cherry Studio сам добавит /v1/chat/completions, поэтому достаточно https://www.ruapi.ai. Вариант https://www.ruapi.ai/v1 обычно тоже работает (Cherry Studio дедуплицирует).
Включите переключатель Активно.
5

Добавьте модели

Ниже в той же панели нажмите + Добавить модель и введите ID моделей — точные имена возьмите со страницы цен. Доступны семейства GPT, GPT mini, Claude Sonnet, Claude Opus, Claude Haiku, DeepSeek, Gemini Pro и другие.Полный список — на странице цен.
Нажмите Получить список моделей — Cherry Studio подтянет весь каталог через /v1/models и добавит все модели сразу.

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

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

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

Настройки → Модели по умолчанию:
  • Модель ассистента по умолчанию: для обычных диалогов. Рекомендуем семейство GPT или Claude Sonnet.
  • Модель для названий тем: автоматически придумывает заголовки для чатов. Рекомендуем дешёвую Claude Haiku.
  • Модель для перевода: подойдут GPT mini или Claude Haiku.

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

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

​
Продвинутое

  • Локальная база знаний: встроенный RAG в Cherry Studio требует embedding-модель. Сейчас моделей эмбеддингов на RuAPI нет — подключите для базы знаний embedding-модель другого провайдера или локальную, а чат оставьте на RuAPI.
  • Агенты: система агентов Cherry Studio полностью клиентская и вызывает настроенного провайдера. Семейства Claude Sonnet или GPT отлично подходят как «мозг» агента.
  • Несколько ключей: если одного ключа не хватает — создайте несколько в Консоли RuAPI со своими лимитами и распределите по разным профилям Cherry Studio.