Перейти к основному содержимому

Cherry Studio

Cherry Studio подключается через OpenAI compatible Provider с Base URL /v1.

Перед настройкой​

  • На этой странице используются только заполнители. Реальный Key копируйте со страницы PopGo API keys, модель со страницы models and pricing.
  • Настройка в один клик подходит для уже установленного ПО с зарегистрированным обработчиком протокола. Разрешите браузеру открыть внешнее приложение.
  • При ручной настройке сначала сохраните минимальный Provider. Включайте streaming, tools или маршрутизацию нескольких моделей после первого успешного запроса.

Официальный источник и проверка​

Cherry Studio 1.9.12 проверен 2026-07-13 по официальному источнику. Официальный источник. Проверена настройка пользовательского Provider в Cherry Studio.

Настройка одним действием​

Войдите на страницу ключей PopGo API и откройте меню действий нужной строки Key. Публичная документация не создаёт и не показывает ссылок, содержащих Key. Откройте подменю Chat и выберите Cherry Studio. После импорта подтвердите OpenAI compatible и выберите доступную модель.

Ручная настройка​

Выберите OpenAI compatible Provider и заполните поля ниже.

ПолеЗначение
Тип ProviderOpenAI compatible
Base URLhttps://api.popgo.site/v1
API KeyYOUR_API_KEY
ModelYOUR_MODEL

Настройка по текстовым шагам​

  1. Установите или обновите Cherry Studio до текущей версии и откройте «Настройки → Сервисы моделей».
  2. Создайте пользовательский Provider и выберите OpenAI compatible. Не изменяйте встроенный официальный Provider.
  3. Укажите https://api.popgo.site/v1 в Base URL, YOUR_API_KEY в API Key и YOUR_MODEL в Model.
  4. Сохраните настройку, создайте новый диалог и сначала отправьте короткое сообщение. Изображения, видео, tools и длинный контекст включайте после успеха.
  5. Для разных протоколов или семейств моделей создавайте отдельные Provider, чтобы не смешивать адреса.

Частые симптомы настройки​

  • Пустой список моделей не всегда означает ошибку. Если клиент не получает сторонние модели, введите YOUR_MODEL вручную.
  • Если после сохранения используется сервис по умолчанию, выберите новый Provider, закройте старый диалог и перезапустите клиент.
  • Если новая возможность отсутствует в старой версии, обновите клиент и ориентируйтесь на поля текущего интерфейса.

Проверка успеха​

Отправьте короткое сообщение из теста модели или нового диалога; нормальный ответ подтверждает успех.

Типичные ошибки и восстановление​

  • При ошибке соединения проверьте, что /v1 не повторяется в конце Base URL.
  • При 401 вставьте YOUR_API_KEY заново и удалите пробелы по краям.
  • При 404 проверьте уровень Base URL и отсутствие повторного /v1 со стороны клиента.