Как подключить GPT к Cherry Studio
Выберите протокол, укажите базовый URL и точный ID модели, а затем проверьте один короткий запрос.
Запрос «как подключить GPT в Cherry Studio» обычно означает, что нужно настроить Provider: выбрать протокол, вставить API-ключ, указать адрес и добавить настоящий ID модели.
Короткий путь выглядит так: Настройки → Сервисы моделей → выбрать или добавить Provider → заполнить ключ и URL → получить или добавить модель → включить Provider → выполнить проверку.
Cherry Studio содержит готовые Provider для OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Ollama и LM Studio. Для шлюза или собственного сервера используйте пользовательский Provider. Актуальные названия полей находятся в официальной инструкции по сервисам моделей.
Что подготовить
До открытия приложения найдите в документации сервиса:
| Параметр | Что это |
|---|---|
| Протокол | 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.
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.
| Ошибка | Первая проверка |
|---|---|
401 | Ключ, протокол и лишние пробелы |
403 | Права, баланс или лимит ключа |
404 | Корневой URL и путь протокола |
400 | Уберите дополнительные параметры и повторите короткий текст |
model not found | Точный ID модели и добавление в список Cherry Studio |
| Текст работает, инструменты нет | Возможности модели и протокол |
Меняйте только один параметр за раз: один Provider, одна модель и один короткий запрос.
Несколько моделей и OmniaKey
В диалоге можно переключать модели или отправлять один вопрос нескольким выбранным моделям. Каждый выбор создаёт отдельный запрос; это не автоматическое голосование. Учитывайте расходы и объём отправляемых данных. Подробнее описано в официальной инструкции сравнения.
OmniaKey можно настроить как единый OpenAI-compatible Provider для GPT, Claude, Gemini и других моделей:
- Создайте отдельный ключ на странице API Keys.
- В Cherry Studio откройте Настройки → Сервисы моделей → Добавить Provider.
- Возьмите URL и формат из быстрого старта OmniaKey.
- Добавьте точный ID из текущего каталога и проверьте короткий запрос.
Каталог и возможности меняются, поэтому не копируйте ID из старой статьи. OpenAI-compatible маршрут не означает одинаковую поддержку vision и tools для всех моделей.
Частые вопросы
Можно ли подключить любой URL?
Только если сервис документирует поддерживаемый протокол, авторизацию и ID модели. Одного URL недостаточно.
Подходит ли подписка ChatGPT?
Не вставляйте данные входа на сайт в поле API-ключа. Нужны API-права или ключ совместимого шлюза.
Почему чат работает, а Agent нет?
Успешный текстовый ответ подтверждает только базовый маршрут. Проверьте модель, протокол и поддержку инструментов отдельно.