NezhaGateNezhaGate
简体中文EnglishEspañol한국어日本語Русский ✓
Войти Регистрация
← Все инструкции

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

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

Около 10 минут · Проверено на версии Cherry Studio 2.1

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

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

  1. Откройте nezhagate.com и нажмите «Зарегистрироваться бесплатно» в правом верхнем углу. Подойдёт регистрация по email, либо вход в один клик через Google или GitHub.
  2. Перейдите в «Консоль» → «API-ключи». В блоке «Создать API-ключ» задайте имя ключа в поле «Название ключа» (например, cherry), оставьте «Лимит на ключ (USD, 0 = без ограничений)» равным 0 (без ограничения) и нажмите «Создать ключ».
  3. Появится ключ, начинающийся с sk-. Скопируйте его сразу же: он показывается только один раз.
[Скриншот: «Консоль» → «API-ключи», выделены кнопка «Создать ключ» и кнопка копирования нового ключа]
Проверяйте и пополняйте баланс на странице «Оплата». Вы платите только за то, что используете, а неудачные запросы никогда не оплачиваются. Цены по каждой модели — на странице цен.

Шаг 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 оставьте пустым.
OpenAI
https://nezhagate.com/v1
  1. Под полем появится подсказка «Request path: https://nezhagate.com/v1/chat/completions» (путь запроса — итоговый адрес, на который пойдут запросы). Если всё совпадает, нажмите Add (добавить).
[Скриншот: диалог Add Custom Provider с отмеченными полями Provider Name, API Key, адресом OpenAI и предпросмотром Request path]

Шаг 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 (готово).
[Скриншот: диалог выбора моделей с отмеченными чат-моделями и выделенной кнопкой Add selected models]
Не нажимайте Skip (пропустить). Если пропустить этот шаг, провайдер останется выключен, и переключатель в правом верхнем углу страницы провайдера придётся включать вручную. У включённого провайдера в списке горит зелёная точка.

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

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

  1. Вернитесь на экран чата, откройте выбор модели и выберите любую модель в группе NezhaGate.
  2. Отправьте сообщение «Hello». Как только придёт ответ — всё готово.
[Скриншот: выбор модели на экране чата со списком моделей в группе NezhaGate]

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

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

Актуальные цены — на странице цен.

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

Всё ещё на версии 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 или FAQ.

Ещё нет API-ключа?

Зарегистрируйтесь и создайте ключ в консоли. Оплата по факту использования; неудачные запросы никогда не оплачиваются.

Получить API-ключ → Цены

Другие инструкции: SillyTavern · Cline