Cherry Studio: подключение своего OpenAI-совместимого API

Что такое Cherry Studio

Cherry Studio — бесплатный open-source десктоп-клиент для работы с LLM на Windows, macOS и Linux. Никакого сервера и Docker: скачали приложение — и работаете. Внутри — готовые ассистенты, базы знаний с RAG, переводчик, мини-приложения и поддержка MCP. С подключённым LLMost весь каталог моделей доступен в любом чате и ассистенте.

Требования

Windows, macOS или Linux
Аккаунт LLMost с API-ключом

Установка

Скачайте установщик со страницы cherry-ai.com или из релизов на GitHub: .exe для Windows, .dmg для macOS, .AppImage для Linux. Запустите — на этом установка закончена.

Подключение LLMost

Создайте ключ на странице Ключи API (формат llmost_...).
В Cherry Studio откройте Настройки (шестерёнка внизу слева) → Сервисы моделей (Model Services).
Внизу списка провайдеров нажмите + Добавить и заполните:
- Название: LLMost
- Тип провайдера: OpenAI
На странице нового провайдера укажите:
- API-ключ: ваш ключ llmost_...
- Адрес API (API Host):
```
https://llmost.ru/api/v1
```
Под полем адреса Cherry Studio показывает предпросмотр итогового URL — он должен выглядеть как https://llmost.ru/api/v1/chat/completions.
Нажмите Управление (Manage) под списком моделей — Cherry Studio загрузит каталог LLMost автоматически. Отметьте нужные модели кнопкой «+»; добавить модель можно и вручную по её ID.
Кнопка Проверить (Check) рядом с ключом сделает тестовый запрос к выбранной модели.

Про адрес API. Cherry Studio сам дописывает /v1, если версии в адресе нет: варианты https://llmost.ru/api и https://llmost.ru/api/v1 дают один и тот же результат. Символ # в конце адреса отключает автодополнение и использует URL ровно как введён — для LLMost это не нужно. В старых версиях (до 1.7) действовало другое правило со слэшем на конце — ориентируйтесь на предпросмотр URL под полем ввода.

Выбор модели

Для повседневной работы достаточно двух-трёх моделей:

~openai/gpt-latest — универсальная флагманская модель, «как ChatGPT»;
~google/gemini-flash-latest — быстрая и дешёвая для повседневных вопросов;
~anthropic/claude-sonnet-latest — сложные задачи, код и длинные документы.

Алиасы, начинающиеся с ~, всегда указывают на актуальную версию модели. Модель по умолчанию назначается в Настройки → Модель по умолчанию. Полный список с ценами — в каталоге моделей LLMost.

Проверка

Создайте новый чат, выберите модель LLMost в селекторе вверху и отправьте сообщение. Если пришёл ответ — соединение работает.

Чтобы проверить подключение в обход Cherry Studio, выполните запрос напрямую:

curl https://llmost.ru/api/v1/chat/completions \
  -H "Authorization: Bearer llmost_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "~google/gemini-flash-latest",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Частые проблемы

Ошибка 404 при отправке сообщения. Итоговый URL сформирован неправильно — посмотрите предпросмотр под полем адреса: он должен быть https://llmost.ru/api/v1/chat/completions. Уберите лишние сегменты пути и символ #, если добавляли его.

Проверка ключа не проходит (401). Ключ скопирован не полностью или удалён. Создайте новый на странице Ключи API.

Модели отвечают ошибкой 402. Закончился баланс LLMost — пополните его в личном кабинете.

Кнопка «Управление» не показывает модели. Список загружается запросом к https://llmost.ru/api/v1/models с вашим ключом — проверьте ключ и адрес API. Модель также можно добавить вручную, указав ID из каталога LLMost.

Ссылки

Официальный сайт: cherry-ai.com
Документация: docs.cherry-ai.com
GitHub: CherryHQ/cherry-studio
Другие приложения — в каталоге ИИ-агентов

Cherry Studio + LLMost: настройка провайдера