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

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

1

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

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

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

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

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

1

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

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

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

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

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

ПолеЗначение
Название провайдераRuAPI
Тип провайдераOpenAI
Нажмите ОК.
4

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

В панели свойств RuAPI:
ПолеЗначение
API-ключsk-ваш-ключ
API-адресhttps://www.ruapi.ai
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, Grok и другие.Полный список — на странице цен.
Нажмите Получить список моделей — Cherry Studio подтянет весь каталог через /v1/models и добавит все модели сразу.

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

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

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

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

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

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

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

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