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

На этой странице описаны Настройки → Сервисы моделей Здесь описаны функции страницы настройки отдельного провайдера. Полный процесс настройки конкретного провайдера см. в разделе «Настройка провайдера».

• Для встроенных провайдеров обычно достаточно заполнить соответствующий API-ключ.
• У разных провайдеров ключ называется по-разному: 密钥, Key, API Key, токен — это всё одно и то же.

API-ключ

Достаточно ввести API-ключ провайдера. Cherry Studio поддерживает несколько ключей у одного провайдера и их циклическое использование（цикл по списку от начала к концу). Есть два способа управления:

• Быстрое добавление：несколько ключей через английскую запятую разделяются и вводятся напрямую, например sk-xxx1,sk-xxx2,sk-xxx3.
• Управление API-ключами：нажмите справа от поля ввода API-ключа на кнопку с иконкой ключа（при наведении появляется «Управление API-ключами»）, чтобы перейти туда — каждый ключ является отдельной записью и может по отдельности редактировать метку、включать / отключать、Копировать、Удалить.

При разделении нескольких ключей запятыми необходимо использовать английскую запятую.

API-адрес

Для встроенных провайдеров обычно не нужно указывать API-адрес (достаточно значения по умолчанию). Если нужно изменить, заполните по официальной документации провайдера.

Если провайдер предоставляет https://xxx.com/v1/chat/completions такой полный адрес, обычно указывают только базовый адрес https://xxx.com достаточно, Cherry Studio автоматически добавит /v1/chat/completions.

Если путь запроса у провайдера нестандартный /v1/chat/completionsто в поле API-адреса можно указать полный адрес и завершить его # окончанием— если # указан конец, путь версии больше не добавляется автоматически, используется только введённый вами адрес.

Добавить модель

На странице настройки провайдера нажмите «Получить список моделей» — будет загружен список моделей, поддерживаемых этим провайдером; в открывшемся списке «Управление моделями» нажмите справа от модели на + чтобы добавить её в свой список моделей.Только модели, добавленные в список, будут отображаться везде в списках выбора моделей.

Под названием модели будет отображаться возвращаемый провайдером фактический API ID модели。Модели с похожими названиями, например с датой в названии или с префиксом поставщика, больше не будут объединяться; перед добавлением или выбором модели сначала проверьте эту строку ID, чтобы не выбрать другую версию с тем же названием.

Проверка подключения

Нажмите «Проверить» и выберите модель, чтобы проверить, успешно ли выполнена настройка (при нескольких ключах можно также выбрать, каким ключом проверять). Если проверка не удалась, проверьте, нет ли в списке моделей ошибочно введённых или неподдерживаемых моделей.

Настройки API (дополнительно)

У некоторых провайдеров в «Настройках API» можно включить определённые возможности, например: поддержку message content в формате массива, Developer Message,enable_thinking（управление «мышлением» моделей вроде Qwen3）,service_tier（только OpenAI）и т. п. Обычно менять не нужно.

После настройки обязательно включите в правом верхнем углу провайдера переключатель «Включено»иначе провайдер останется неактивным, и его модели не будут отображаться в списке выбора моделей.

---

Получить помощь и отправить отзыв

Если у вас в процессе настройки или использования возникнут какие-либо вопросы, баги или предложения по улучшению функций, пожалуйста, обратитесь к Отзывы и предложения официальным каналам, указанным там.