> ## 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

> Как подключить десктопный клиент Cherry Studio к RuAPI

[Cherry Studio](https://cherry-ai.com) — кроссплатформенный десктопный AI-клиент с открытым кодом. Поддерживает несколько LLM-провайдеров одновременно, локальную базу знаний, агентов. RuAPI подключается через **OpenAI-совместимый** протокол.

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

<Steps>
  <Step title="Аккаунт RuAPI и API-ключ">
    Консоль → **Токены** → создайте ключ `sk-...`.
  </Step>
</Steps>

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

Скачайте с [cherry-ai.com](https://cherry-ai.com) или со [страницы релизов GitHub](https://github.com/CherryHQ/cherry-studio/releases/latest):

<Tabs>
  <Tab title="Windows">
    Скачайте `Cherry-Studio-Setup-x.y.z.exe` и запустите установщик.
  </Tab>

  <Tab title="macOS">
    Скачайте `Cherry-Studio-x.y.z-arm64.dmg` (Apple Silicon) или `Cherry-Studio-x.y.z-x64.dmg` (Intel) и перетащите в **Программы**.
  </Tab>

  <Tab title="Linux">
    Скачайте `Cherry-Studio-x.y.z.AppImage`:

    ```bash theme={null}
    chmod +x Cherry-Studio-*.AppImage
    ./Cherry-Studio-*.AppImage
    ```
  </Tab>
</Tabs>

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

<Steps>
  <Step title="Откройте «Настройки → Модели»">
    После запуска Cherry Studio нажмите ⚙️ в левом нижнем углу → **Настройки** → **Сервисы моделей** в левой панели.
  </Step>

  <Step title="Нажмите «Добавить»">
    Кнопка **+ Добавить** внизу списка провайдеров.
  </Step>

  <Step title="Основная информация">
    | Поле                    | Значение   |
    | ----------------------- | ---------- |
    | **Название провайдера** | `RuAPI`    |
    | **Тип провайдера**      | **OpenAI** |

    Нажмите **ОК**.
  </Step>

  <Step title="API-ключ и адрес">
    В панели свойств RuAPI:

    | Поле          | Значение               |
    | ------------- | ---------------------- |
    | **API-ключ**  | `sk-ваш-ключ`          |
    | **API-адрес** | `https://www.ruapi.ai` |

    <Note>
      Cherry Studio сам добавит `/v1/chat/completions`, поэтому достаточно `https://www.ruapi.ai`. Вариант `https://www.ruapi.ai/v1` обычно тоже работает (Cherry Studio дедуплицирует).
    </Note>

    Включите переключатель **Активно**.
  </Step>

  <Step title="Добавьте модели">
    Ниже в той же панели нажмите **+ Добавить модель** и введите ID моделей — точные имена возьмите со страницы цен. Доступны семейства GPT, GPT mini, Claude Sonnet, Claude Opus, Claude Haiku, DeepSeek, Gemini Pro и другие.

    Полный список — на [странице цен](https://www.ruapi.ai/pricing).

    <Tip>
      Нажмите **Получить список моделей** — Cherry Studio подтянет весь каталог через `/v1/models` и добавит все модели сразу.
    </Tip>
  </Step>
</Steps>

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

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

```
Расскажи о себе одним предложением.
```

Нормальный ответ + запись в Консоли RuAPI → **Логи** = всё работает.

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

**Настройки → Модели по умолчанию**:

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

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

<AccordionGroup>
  <Accordion title="401 / ошибка аутентификации">
    * API-ключ должен быть **токеном RuAPI** (`sk-...`), а не ключом OpenAI.
    * Следите за пробелами в конце.
    * Проверьте состояние ключа в Консоли RuAPI → **Токены**.
  </Accordion>

  <Accordion title="Модель не найдена / 404">
    * Опечатка в ID. Имена моделей, введённые вручную, должны полностью совпадать с RuAPI — используйте **Получить список моделей** для автозаполнения.
    * Не добавляйте `/chat/completions` к API-адресу — достаточно `https://www.ruapi.ai`.
  </Accordion>

  <Accordion title="Стриминг подвисает / тормозит">
    Стриминг (SSE) включён по умолчанию у обеих сторон. Если есть лаги:

    * Проверьте стабильность сети.
    * Попробуйте отключить стриминг в настройках и сравнить.
  </Accordion>

  <Accordion title="Function calling / инструменты не работают">
    MCP в Cherry Studio опирается на function calling в модели. Семейства GPT и Claude Sonnet поддерживают это для совместимых моделей — сверяйтесь с бейджами возможностей на [странице цен](https://www.ruapi.ai/pricing).
  </Accordion>

  <Accordion title="Не работает ввод изображений (vision)">
    Убедитесь, что выбранная модель умеет работать с изображениями. На RuAPI vision-модели: семейства GPT, Claude Sonnet, Claude Opus, Gemini Pro. Бейджи возможностей — на [странице цен](https://www.ruapi.ai/pricing).
  </Accordion>

  <Accordion title="Использовать RuAPI вместе с другими провайдерами">
    Cherry Studio поддерживает сколько угодно провайдеров. Добавьте каждый по той же схеме. Переключатель в правом верхнем углу чата меняет провайдера и модель.
  </Accordion>
</AccordionGroup>

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

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