Предварительные требования
Аккаунт RuAPI и API-ключ
sk-....deepseek-flash, проверка): в разделе «Добавление RuAPI как провайдера» останется только последний шаг — выбрать модели по умолчанию.
Консоль → API-ключи: кнопка «Подключить Claude Code, Cline и др.»

Окно «Подключить программу», выбран Cherry Studio: адрес и ключ уже подставлены (на скриншоте ключ скрыт)
Установка Cherry Studio
Скачайте с cherry-ai.com или со страницы релизов GitHub:- Windows
- macOS
- Linux
Cherry-Studio-Setup-x.y.z.exe и запустите установщик.Добавление RuAPI как провайдера
Инструкция и скриншоты — для Cherry Studio 2.1.6 (октябрь 2026). В других версиях названия кнопок могут немного отличаться.Откройте добавление провайдера
Заполните форму
https://www.ruapi.ai/v1/chat/completions — значит, адрес указан верно. Поле Anthropic можно оставить пустым. Нажмите «Добавить».
Форма нового провайдера: имя, ключ и адрес OpenAI
Добавьте модель deepseek-flash
deepseek-flash (поля «Имя модели» и «Имя группы» заполнятся сами) и нажмите «Добавить модель».deepseek-flash, claude-haiku-5-5 и gpt-6-luna. После пополнения от 5 $ остальные модели можно добавить кнопкой «Синхронизировать модели» — просто отметьте их в списке. Цены — на странице цен.
Добавление модели: в поле «ID модели» — deepseek-flash
Проверьте и включите провайдера

Проверка deepseek-flash
deepseek-flash.
Провайдер RuAPI настроен и включён
Выберите модели по умолчанию
deepseek-flash из группы RuAPI — два других поля заполнятся той же моделью. Нажмите «Начать».
Все три модели по умолчанию — deepseek-flash
Первый запрос
Откройте «Чат» (значок сообщения на левой панели), вверху нажмите на название модели и выберите модель из группы RuAPI. Отправьте:Модели по умолчанию
Настройки → «Модель по умолчанию»:- Модель ассистента по умолчанию: для обычных диалогов. Рекомендуем семейство GPT или Claude Sonnet.
- Быстрая модель: для простых задач — названия чатов, ключевые слова для поиска. Подойдёт дешёвая Claude Haiku.
- Модель перевода: подойдут GPT mini или Claude Haiku.
deepseek-flash из группы RuAPI: по умолчанию Cherry Studio использует свою встроенную модель, а не RuAPI.
Решение проблем
401 / ошибка аутентификации
401 / ошибка аутентификации
- API-ключ должен быть ключом RuAPI (
sk-...), а не ключом OpenAI. - Следите за пробелами в конце.
- Проверьте состояние ключа в Консоли RuAPI → API-ключи.
Модель не найдена (503) или 404
Модель не найдена (503) или 404
- Опечатка в ID. При ручном добавлении «ID модели» должен полностью совпадать с RuAPI (например,
deepseek-flash), без пробелов в начале и в конце. Остальные модели проще добавить кнопкой «Синхронизировать модели», отметив их в списке. - Не добавляйте
/chat/completionsк API-адресу — достаточноhttps://www.ruapi.ai.
Стриминг подвисает / тормозит
Стриминг подвисает / тормозит
- Проверьте стабильность сети.
- Попробуйте отключить стриминг в настройках и сравнить.
Function calling / инструменты не работают
Function calling / инструменты не работают
Не работает ввод изображений (vision)
Не работает ввод изображений (vision)
deepseek-flash; модели GLM работают только с текстом — см. работу с изображениями.Использовать RuAPI вместе с другими провайдерами
Использовать RuAPI вместе с другими провайдерами
Продвинутое
- База знаний: встроенному 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.