# Как подключить GPT к Cherry Studio > Настройте GPT, OpenAI-совместимый API, Claude, Gemini или локальную модель в Cherry Studio. Выберите Provider, добавьте модель и исправьте ошибки 401 и 404. - Canonical HTML: https://omniakey.com/ru/blog/cherry-studio-api-setup - Markdown: https://omniakey.com/ru/blog/cherry-studio-api-setup.md - Published: 2026-09-17 (updated 2026-09-21) - Author: Kiki, COO at OmniaKey - Language: ru - Category: API setup - Reading time: 12 min - All posts: https://omniakey.com/blog/llms.txt --- Запрос **«как подключить GPT в Cherry Studio»** обычно означает, что нужно настроить Provider: выбрать протокол, вставить API-ключ, указать адрес и добавить настоящий ID модели. Короткий путь выглядит так: **Настройки → Сервисы моделей → выбрать или добавить Provider → заполнить ключ и URL → получить или добавить модель → включить Provider → выполнить проверку**. Cherry Studio содержит готовые Provider для OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Ollama и LM Studio. Для шлюза или собственного сервера используйте пользовательский Provider. Актуальные названия полей находятся в [официальной инструкции по сервисам моделей](https://docs.cherryai.com.cn/pre-basic/providers/providers.md). ## Что подготовить До открытия приложения найдите в документации сервиса: |Параметр|Что это| |-|-| |Протокол|OpenAI-compatible, Anthropic Messages, Gemini или другой явно указанный формат| |API-ключ|Секрет для авторизации запроса| |Base URL|Обычно корневой адрес API| |ID модели|Точная строка, которую принимает сервер| Пароль от веб-сайта не является API-ключом. Подписка ChatGPT, официальный API и сторонний шлюз требуют разных учётных данных. ## Настройка GPT в Cherry Studio ### 1. Откройте сервисы моделей Запустите Cherry Studio и откройте **Настройки → Сервисы моделей**. Прямой OpenAI API настраивайте через встроенный Provider OpenAI. Для агрегатора или собственного сервера нажмите **Добавить Provider**. Provider выбирается по протоколу, а не по слову GPT в названии модели. ### 2. Заполните поля |Поле|Что указать|Чего избегать| |-|-|-| |Имя Provider|Понятная подпись для этого подключения|Одинаковое имя для разных адресов| |API-ключ|Только значение ключа|Пробелы, кавычки и `Bearer`| |Тип API|Протокол из документации сервиса|Догадки по названию модели| |API-адрес|Корневой URL или полный URL, если это требуется|Адрес панели управления или двойной `/v1`| Для обычного OpenAI-compatible сервиса обычно указывают корневой адрес, а клиент добавляет путь запроса. Если документация показывает `https://api.example.com` и `https://api.example.com/v1/chat/completions`, первым обычно является Base URL. Полный путь используйте только по прямому указанию сервиса. Подробности есть в [инструкции по пользовательскому Provider](https://docs.cherryai.com.cn/pre-basic/providers/zi-ding-yi-fu-wu-shang.md). ### 3. Получите или добавьте модель Нажмите **Получить список моделей** и добавьте нужную модель кнопкой `+`. ID из ответа сервера важнее отображаемого названия: не удаляйте дату, префикс поставщика или суффикс версии. Если список не поддерживается, добавьте ID вручную. После этого включите Provider справа; иначе модель не появится в списке чата. ### 4. Проверьте короткий запрос Нажмите **Проверить** и отправьте: ```text Ответьте точно: подключение успешно ``` Сначала проверьте обычный текст. Изображения, инструменты и reasoning включайте по одному после успешного базового запроса. ## Другие сторонние API Для шлюза OpenAI-compatible выберите пользовательский Provider с типом OpenAI. Для шлюза, который предоставляет OpenAI Chat, Responses, Anthropic и Gemini от одного корневого адреса, используйте [инструкцию NewAPI](https://docs.cherryai.com.cn/pre-basic/providers/newapi.md). Для Ollama, LM Studio и vLLM укажите фактическое имя загруженной локальной модели. ## Пустой список моделей и ошибки Если список пуст, проверьте: есть ли у сервиса endpoint моделей, не дублируется ли `/v1`, указан ли API-адрес вместо административной панели, точно ли скопирован ID и включён ли Provider. |Ошибка|Первая проверка| |-|-| |`401`|Ключ, протокол и лишние пробелы| |`403`|Права, баланс или лимит ключа| |`404`|Корневой URL и путь протокола| |`400`|Уберите дополнительные параметры и повторите короткий текст| |`model not found`|Точный ID модели и добавление в список Cherry Studio| |Текст работает, инструменты нет|Возможности модели и протокол| Меняйте только один параметр за раз: один Provider, одна модель и один короткий запрос. ## Несколько моделей и OmniaKey В диалоге можно переключать модели или отправлять один вопрос нескольким выбранным моделям. Каждый выбор создаёт отдельный запрос; это не автоматическое голосование. Учитывайте расходы и объём отправляемых данных. Подробнее описано в [официальной инструкции сравнения](https://docs.cherryai.com.cn/advanced-basic/chat/model-compare-branches.md). OmniaKey можно настроить как единый OpenAI-compatible Provider для GPT, Claude, Gemini и других моделей: 1. Создайте отдельный ключ на [странице API Keys](https://omniakey.com/ru/dashboard/tokens). 2. В Cherry Studio откройте **Настройки → Сервисы моделей → Добавить Provider**. 3. Возьмите URL и формат из [быстрого старта OmniaKey](https://docs.omniakey.com/ru/quick-start). 4. Добавьте точный ID из [текущего каталога](https://omniakey.com/ru/models) и проверьте короткий запрос. 5. Включите Provider, выполните короткую проверку и подтвердите запрос на [странице использования](https://omniakey.com/ru/dashboard/usage). Каталог и возможности меняются, поэтому не копируйте ID из старой статьи. OpenAI-compatible маршрут не означает одинаковую поддержку vision и tools для всех моделей. Тот же ключ работает и в других инструментах; см. руководства [Как подключить свою модель в WorkBuddy](https://omniakey.com/ru/blog/workbuddy-custom-model-setup), [Как подключить свой API-ключ в Cline](https://omniakey.com/ru/blog/cline-custom-api-key) и [Claude Code с OmniaKey](https://omniakey.com/ru/blog/claude-code-setup). ## Частые вопросы ### Можно ли подключить любой URL? Только если сервис документирует поддерживаемый протокол, авторизацию и ID модели. Одного URL недостаточно. ### Вводить корневой URL или `/chat/completions`? Следуйте документации сервиса. Обычный Provider принимает корневой URL, а путь запроса добавляет Cherry Studio; полный адрес указывайте только по прямому требованию сервиса. ### Подходит ли подписка ChatGPT? Не вставляйте данные входа на сайт в поле API-ключа. Нужны API-права или ключ совместимого шлюза. ### Почему чат работает, а Agent нет? Успешный текстовый ответ подтверждает только базовый маршрут. Проверьте модель, протокол и поддержку инструментов отдельно. ## Проверенные источники - [Cherry Studio: Настройки сервисов моделей](https://docs.cherryai.com.cn/pre-basic/providers/providers.md) - [Cherry Studio: Пользовательский Provider](https://docs.cherryai.com.cn/pre-basic/providers/zi-ding-yi-fu-wu-shang.md) - [Cherry Studio: NewAPI](https://docs.cherryai.com.cn/pre-basic/providers/newapi.md) - [Cherry Studio: Сравнение нескольких моделей и ветки сообщений](https://docs.cherryai.com.cn/advanced-basic/chat/model-compare-branches.md) Технические значения, такие как ID моделей, возможности Provider и адреса запросов, могут меняться; проверяйте их в момент настройки.