Как подключить GPT к Cherry Studio

Запрос «как подключить GPT в Cherry Studio» обычно означает, что нужно настроить Provider: выбрать протокол, вставить API-ключ, указать адрес и добавить настоящий ID модели.

Короткий путь выглядит так: Настройки → Сервисы моделей → выбрать или добавить Provider → заполнить ключ и URL → получить или добавить модель → включить Provider → выполнить проверку.

Cherry Studio содержит готовые Provider для OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Ollama и LM Studio. Для шлюза или собственного сервера используйте пользовательский Provider. Актуальные названия полей находятся в официальной инструкции по сервисам моделей.

Что подготовить

До открытия приложения найдите в документации сервиса:

Пароль от веб-сайта не является API-ключом. Подписка ChatGPT, официальный API и сторонний шлюз требуют разных учётных данных.

Настройка GPT в Cherry Studio

1. Откройте сервисы моделей

Запустите Cherry Studio и откройте Настройки → Сервисы моделей. Прямой OpenAI API настраивайте через встроенный Provider OpenAI. Для агрегатора или собственного сервера нажмите Добавить Provider.

Provider выбирается по протоколу, а не по слову GPT в названии модели.

2. Заполните поля

Для обычного OpenAI-compatible сервиса обычно указывают корневой адрес, а клиент добавляет путь запроса. Если документация показывает https://api.example.com и https://api.example.com/v1/chat/completions, первым обычно является Base URL. Полный путь используйте только по прямому указанию сервиса. Подробности есть в инструкции по пользовательскому Provider.

3. Получите или добавьте модель

Нажмите Получить список моделей и добавьте нужную модель кнопкой +. ID из ответа сервера важнее отображаемого названия: не удаляйте дату, префикс поставщика или суффикс версии.

Если список не поддерживается, добавьте ID вручную. После этого включите Provider справа; иначе модель не появится в списке чата.

4. Проверьте короткий запрос

Нажмите Проверить и отправьте:

Ответьте точно: подключение успешно

Сначала проверьте обычный текст. Изображения, инструменты и reasoning включайте по одному после успешного базового запроса.

Другие сторонние API

Для шлюза OpenAI-compatible выберите пользовательский Provider с типом OpenAI. Для шлюза, который предоставляет OpenAI Chat, Responses, Anthropic и Gemini от одного корневого адреса, используйте инструкцию NewAPI. Для Ollama, LM Studio и vLLM укажите фактическое имя загруженной локальной модели.

Пустой список моделей и ошибки

Если список пуст, проверьте: есть ли у сервиса endpoint моделей, не дублируется ли /v1, указан ли API-адрес вместо административной панели, точно ли скопирован ID и включён ли Provider.

Меняйте только один параметр за раз: один Provider, одна модель и один короткий запрос.

Несколько моделей и OmniaKey

В диалоге можно переключать модели или отправлять один вопрос нескольким выбранным моделям. Каждый выбор создаёт отдельный запрос; это не автоматическое голосование. Учитывайте расходы и объём отправляемых данных. Подробнее описано в официальной инструкции сравнения.

OmniaKey можно настроить как единый OpenAI-compatible Provider для GPT, Claude, Gemini и других моделей:

1. Создайте отдельный ключ на странице API Keys.
2. В Cherry Studio откройте Настройки → Сервисы моделей → Добавить Provider.
3. Возьмите URL и формат из быстрого старта OmniaKey.
4. Добавьте точный ID из текущего каталога и проверьте короткий запрос.
5. Включите Provider, выполните короткую проверку и подтвердите запрос на странице использования.

Каталог и возможности меняются, поэтому не копируйте ID из старой статьи. OpenAI-compatible маршрут не означает одинаковую поддержку vision и tools для всех моделей. Тот же ключ работает и в других инструментах; см. руководства Как подключить свою модель в WorkBuddy, Как подключить свой API-ключ в Cline и Claude Code с OmniaKey.

Частые вопросы

Можно ли подключить любой URL?

Только если сервис документирует поддерживаемый протокол, авторизацию и ID модели. Одного URL недостаточно.

Вводить корневой URL или /chat/completions?

Следуйте документации сервиса. Обычный Provider принимает корневой URL, а путь запроса добавляет Cherry Studio; полный адрес указывайте только по прямому требованию сервиса.

Подходит ли подписка ChatGPT?

Не вставляйте данные входа на сайт в поле API-ключа. Нужны API-права или ключ совместимого шлюза.

Почему чат работает, а Agent нет?

Успешный текстовый ответ подтверждает только базовый маршрут. Проверьте модель, протокол и поддержку инструментов отдельно.

Проверенные источники

• Cherry Studio: Настройки сервисов моделей
• Cherry Studio: Пользовательский Provider
• Cherry Studio: NewAPI
• Cherry Studio: Сравнение нескольких моделей и ветки сообщений

Технические значения, такие как ID моделей, возможности Provider и адреса запросов, могут меняться; проверяйте их в момент настройки.