# Cherry Studio + NezhaGate: настройка за 10 минут

Пошагово для новичков: добавьте NezhaGate как провайдера в Cherry Studio, выберите модели, проверьте подключение и начните чат. Разбор частых ошибок.

> https://nezhagate.com/ru/docs/integrations/cherry-studio

## Что вам понадобится

- Cherry Studio 2.x для настольных ОС (Windows, macOS или Linux) — скачайте с сайта Cherry Studio или с GitHub.

- Аккаунт NezhaGate и API-ключ (как его получить — см. шаг 1).

- Около 10 минут.

## Шаг 1. Зарегистрируйтесь в NezhaGate и создайте API-ключ

1. Откройте [nezhagate.com](https://nezhagate.com/ru/) и нажмите «Зарегистрироваться бесплатно» в правом верхнем углу. Подойдёт регистрация по email, либо вход в один клик через Google или GitHub.

2. Перейдите в «Консоль» → «API-ключи». В блоке «Создать API-ключ» задайте имя ключа в поле «Название ключа» (например, `cherry`), оставьте «Лимит на ключ (USD, 0 = без ограничений)» равным 0 (без ограничения) и нажмите «Создать ключ».

3. Появится ключ, начинающийся с `sk-`. **Скопируйте его сразу же**: он показывается только один раз.

Проверяйте и пополняйте баланс на странице «Оплата». Вы платите только за то, что используете, а неудачные запросы никогда не оплачиваются. Цены по каждой модели — на [странице цен](https://nezhagate.com/ru/pricing).

## Шаг 2. Добавьте NezhaGate как провайдера

1. Откройте Cherry Studio, нажмите значок шестерёнки — **Settings** (настройки) — внизу левой панели и перейдите в раздел **Model Provider** (провайдер модели).

2. Под списком провайдеров нажмите **+ Add Provider** (добавить провайдера).

3. В диалоговом окне **Add Custom Provider** (добавить своего провайдера) заполните:

   - **Provider Name** (имя провайдера): `NezhaGate`

   - **API Key** (API-ключ): ключ, скопированный в шаге 1

   - В разделе **Endpoint settings** (настройки эндпоинта), в поле **OpenAI** укажите адрес, приведённый ниже. Поле **Anthropic** оставьте пустым.

```
https://nezhagate.com/v1
```

1. Под полем появится подсказка «Request path: https://nezhagate.com/v1/chat/completions» (путь запроса — итоговый адрес, на который пойдут запросы). Если всё совпадает, нажмите **Add** (добавить).

## Шаг 3. Выберите модели, проверьте и включите провайдера

1. Дальше откроется диалог **Choose models** (выбор моделей), уже заполненный списком моделей NezhaGate.

2. **Не нажимайте Select All** (выбрать все): в списке есть и модели для изображений и видео, а они не работают в чате. Отметьте только нужные чат-модели, например `deepseek-v4.1-flash`, `kimi-k3`, `glm-5.3`, `qwen3.7-max` и `claude-opus-5`.

3. Нажмите **Add selected models** (добавить выбранные модели). Cherry Studio проверит одну модель реальным запросом, включит провайдера — и останется нажать **Done** (готово).

Не нажимайте **Skip** (пропустить). Если пропустить этот шаг, провайдер останется выключен, и переключатель в правом верхнем углу страницы провайдера придётся включать вручную. У включённого провайдера в списке горит зелёная точка.

Чтобы добавить модели позже, откройте страницу провайдера NezhaGate и нажмите **Sync models** (синхронизировать модели); если нужной модели нет в списке, используйте **Add model manually** (добавить модель вручную) и введите её ID. Чтобы снова проверить соединение, нажмите **Model Check** (проверка модели), выберите модель и нажмите **Start** (начать): должно появиться «Connection successful» (соединение успешно).

## Шаг 4. Начните общаться

1. Вернитесь на экран чата, откройте выбор модели и выберите любую модель в группе **NezhaGate**.

2. Отправьте сообщение «Hello». Как только придёт ответ — всё готово.

## Рекомендуемые модели

| Задача | ID модели | Комментарий |
| --- | --- | --- |
| Повседневное общение, перевод, суммаризация | `deepseek-v4.1-flash` | Дёшево и быстро — лучшее соотношение цены и качества. |
| Длинные документы, много файлов | `kimi-k3` | Хорошо понимает длинный контекст; кэширование промптов удешевляет повторные вопросы по одному и тому же документу. |
| Программирование и сложные рассуждения | `glm-5.3`, `qwen3.7-max` | Обе модели с рассуждением: чуть медленнее, зато точнее. |
| Самые сложные задачи | `claude-opus-5`, `gpt-6-astra` | Флагманские модели, дороже остальных. |
| Художественная литература и большие тексты | `claude-fable-5` | Сильнее всех в повествовании и длинной прозе. |

Актуальные цены — на [странице цен](https://nezhagate.com/ru/pricing).

## Как правильно указать адрес

- Подойдёт и `https://nezhagate.com/v1`, и просто `https://nezhagate.com`: если версии в пути нет, Cherry Studio сама добавит `/v1`.

- **Не** вводите `/v1/chat/completions`. Путь задвоится, и вы получите 404.

- Символ `#` в конце адреса означает, что Cherry Studio не должна добавлять версию сама. Для NezhaGate он не нужен.

Всё ещё на версии 1.x? Экраны там другие: при добавлении провайдера укажите в **Provider Type** (тип провайдера) значение OpenAI, а в **API Host** (адрес API) — `https://nezhagate.com`, затем добавляйте модели через **Manage** (управление) и проверяйте через **Check** (проверить). Обновиться до 2.x — самый простой путь.

## Частые проблемы и ошибки

| Что вы видите | Что делать |
| --- | --- |
| «The provider returned no available models» (у провайдера нет доступных моделей) или «Failed to pull models» (не удалось получить список моделей) | Проверьте адрес и ключ (без пробелов вокруг ключа) либо используйте **Add model manually** (добавить модель вручную) и введите ID модели. |
| «The model request failed» (запрос к модели не удался) при проверке | Убедитесь, что на счету есть баланс. Модели с рассуждением, например `qwen3.7-max`, иногда отвечают настолько медленно, что проверка обрывается по тайм-ауту; в этом случае проверьте на `deepseek-v4.1-flash`. |
| Модели NezhaGate не отображаются в выборе модели в чате | Провайдер выключен. Зайдите в Settings → Model Provider (настройки → провайдер модели) → NezhaGate и включите переключатель в правом верхнем углу. |
| 404 | В адресе `/v1` указан дважды либо адрес заканчивается на `/chat/completions`. Исправьте на `https://nezhagate.com/v1`. |
| 401 | Ключ неверен или был удалён. Создайте новый в консоли и скопируйте его. |
| 402 | Баланс закончился, либо ключ достиг заданного лимита. Пополните баланс на странице «Оплата» или увеличьте «Лимит на ключ (USD, 0 = без ограничений)» для этого ключа. |
| 400 | Обычно это неподдерживаемый параметр, слишком большой контекст или слишком крупное изображение. Попробуйте ещё раз в новом ассистенте с настройками по умолчанию. Отправка изображения модели без распознавания изображений тоже вернёт 400. |

Не получается разобраться? Смотрите [документацию по API](https://nezhagate.com/ru/docs-guide) или [FAQ](https://nezhagate.com/ru/faq).