Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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-5
  • gpt-5-mini
  • claude-sonnet-4-6
  • claude-opus-4-7
  • claude-haiku-4-5
  • deepseek-chat
  • gemini-2.5-pro
  • grok-3
Полный список — в галерее моделей.
Нажмите Получить список моделей — Cherry Studio подтянет весь каталог через /v1/models и добавит все модели сразу.

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

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

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

Настройки → Модели по умолчанию:
  • Модель ассистента по умолчанию: для обычных диалогов. Рекомендуем gpt-5 или claude-sonnet-4-6.
  • Модель для названий тем: автоматически придумывает заголовки чатам. Рекомендуем дешёвую claude-haiku-4-5.
  • Модель для перевода: подойдут gpt-5-mini или claude-haiku-4-5.

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

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

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

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