Добавьте каждую модель каталога в Cherry Studio одним провайдером.
Updated 2026-07-29
Настройки Model Services в Cherry Studio принимают любой OpenAI-совместимый эндпоинт: добавьте провайдера с типом OpenAI, укажите API-адрес на api.apisrouter.com, вставьте один ключ и добавьте ID моделей вручную. Claude, GPT, DeepSeek, GLM, Kimi и Qwen окажутся в одном пикере на десктопе.
Короткий ответ: один провайдер в Model Services.
Нажмите значок шестерёнки в левой навигации Cherry Studio, откройте вкладку Model Services и нажмите кнопку Add под списком провайдеров. Дайте провайдеру узнаваемое имя (APIsRouter) и выберите OpenAI как тип провайдера, затем сохраните. Теперь выберите нового провайдера в списке и настройте его: включите переключатель, вставьте свой ключ в поле API-ключа и задайте API-адрес как https://api.apisrouter.com. Обратите внимание на форму: задокументированное поведение по умолчанию в Cherry Studio — брать корневой адрес и самостоятельно дописывать к нему /v1/chat/completions, так что вводите хост без /v1. Затем добавьте модели кнопкой Add в разделе моделей, по одному точному ID каталога на запись (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), и нажмите кнопку Check рядом с ключом, чтобы запустить живую проверку против выбранной модели.
Provider name: APIsRouter
Provider type: OpenAI
then, on the provider page:
API key: sk-YOUR-APISROUTER-KEY
API address: https://api.apisrouter.com
(Cherry appends /v1/chat/completions)
Models → + Add: claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → pick a model → successКак Cherry Studio составляет URL запроса.
Cherry Studio (CherryHQ на GitHub, около 49K звёзд) — десктопный клиент китайского происхождения для Windows, macOS и Linux, известный тем, что поставляется с готовыми пресетами для сотен провайдеров и ассистентов. Всё, чего нет в списке пресетов, входит через описанный выше поток кастомного провайдера, и стоит разобраться именно с полем API-адреса. Задокументированное поведение по умолчанию: вы указываете корневой адрес, а Cherry Studio сама конкатенирует к нему маршрут OpenAI, так что https://api.apisrouter.com превращается в https://api.apisrouter.com/v1/chat/completions на проводе. Если у провайдера нестандартный путь, завершение адреса символом # полностью отключает конкатенацию, и адрес используется ровно так, как введён, — это задокументированный выход. Поведение конкатенации вокруг завершающих слэшей менялось между релизами, так что если запросы дают 404, читайте итоговый URL в ошибке, а не гадайте; форма с корневым адресом и автоматическим дописыванием — стабильная конфигурация для стандартного шлюза /v1. После настройки каждый разговор отправляет стандартные chat completions с добавленным вами ID модели как простой строкой. Вендоры не важны для формата на проводе — именно это позволяет одной записи провайдера нести китайские и западные ID каталога вместе.
Детали, которые окупаются: мульти-ключ и управление моделями.
Поле API-ключа принимает больше одного ключа: разделяйте ключи английскими запятыми, и Cherry Studio будет ротировать их сверху вниз по запросам — задокументированная функция балансировки нагрузки. При тарификации по ключу на стороне шлюза это заодно работает как атрибуция: один ключ для работы, один для личного, ротация отключается перечислением всего одного ключа. Записи моделей вводятся вручную, и это плюс. Cherry Studio показывает ровно то, что вы добавили, так что пикер остаётся курируемым, а не тонет в полученном каталоге. Каждая запись берёт ID как строку на проводе; кнопка Manage правит или удаляет записи позже. Группируйте связанные ID с последовательным именованием, и пикер читается как меню: быстрый тир (deepseek-v4-flash, claude-haiku-4-5-20251001), региональная сила (glm-5.2, qwen3.7-plus, kimi-k2.6), флагман (claude-sonnet-4-6). Кнопка Check валидирует пару ключа и адреса против выбранной вами модели, и это самый быстрый способ подтвердить провайдера перед реальными разговорами. Неудачная проверка с корректным ключом почти всегда означает, что поле адреса несёт лишний /v1, удвоивший путь.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# add these ids verbatim in the provider's model listВыбор моделей для настольной рабочей лошадки.
Один ключ означает, что сравнения — это переключения в пикере. Проведите одну и ту же неделю работы на двух кандидатных ID и позвольте расходам по модели в консоли APIsRouter судить наряду с вашей собственной оценкой качества вывода.
- Ежедневный чат и быстрые переписывания живут на быстром тире: deepseek-v4-flash и claude-haiku-4-5-20251001 держат постоянно открытое окно ощущением бесплатного.
- Работа на китайском языке — там, где региональные ID окупают свои строки: glm-5.2 и qwen3.7-plus для черновиков и документов, kimi-k2.6 для чтения длинного контекста.
- claude-sonnet-4-6 берёт на себя разговоры, которые вы пересылаете без правок: внимательный анализ, прозу для клиентов, код, который собираетесь отгрузить.
- Ассистенты Cherry Studio могут закреплять собственную модель на роль, так что ассистент для перевода на glm-5.2 и ассистент для кода на claude-sonnet-4-6 сосуществуют за одним провайдером.
- Добавляйте строки осознанно; курируемый пикер из шести моделей используется, а вставленный целиком каталог — прокручивается мимо.
Оплата по факту · дешевле официальных цен
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| Модель | Официальная цена | Наша цена |
|---|---|---|
| Claude Sonnet 4.6 | $3.00 / $15.00 per M | $2.40 / $12.00 per M |
| DeepSeek V4 Flash | $0.14 / $0.28 per M | $0.10 / $0.30 per M |
| GLM-5.2 | $1.14 / $4.00 per M | $1.10 / $4.00 per M |
| Kimi K2.6 | $0.95 / $4.00 per M | $1.00 / $4.00 per M |
| Qwen 3.7 Plus | $0.29 / $1.14 per M | $0.30 / $1.10 per M |
Сбои, специфичные именно для Cherry Studio.
Удвоенный путь — самая частая жалоба: вставка https://api.apisrouter.com/v1 в поле, которое дописывает /v1/chat/completions, даёт URL /v1/v1, дающие 404. Вводите корневой адрес и позвольте клиенту построить маршрут. Если нужно закрепить точный URL, для этого существует форма с завершающим #. Неудачная проверка (Check) с хорошим ключом обычно связана с формой адреса выше; неудачная проверка с чистым адресом — это ключ, и учтите, что несколько ключей должны разделяться английскими запятыми, поскольку полноширинные символы, вставленные из китайских методов ввода, тихо ломают список. Модели, выдающие ошибку по отдельности, пока другие работают, — это проблема написания ID; записи — свободный текст, а листинг /v1/models — авторитетный источник. И помните, что настройки — на каждую машину: провайдер, настроенный на десктопе, не существует на ноутбуке, пока вы не повторите двухминутную настройку или не используете собственные функции резервного копирования Cherry Studio. Заметка о расхождении версий: Cherry Studio выпускается часто, и подписи настроек смещаются (Model Services также встречался как Model Provider в некоторых сборках); поток «добавить провайдера, выбрать тип OpenAI, ключ, адрес, модели» оставался стабильным.
Кто направляет Cherry Studio через шлюз.
- Двуязычные пользователи десктопа, смешивающие GLM, Qwen, Kimi и DeepSeek с Claude и GPT в одном пикере, с одним балансом и без вендорских аккаунтов.
- Пользователи в Азии, желающие ID Claude и GPT на предоплаченном балансе без западной карты, рядом с региональными моделями, которыми уже пользуются.
- Продвинутые пользователи, запускающие ассистентов Cherry Studio по ролям и желающие закрепить каждого за нужным вендором, не управляя пятью ключами.
- Люди, уже направляющие другие инструменты через шлюз и желающие видеть десктопный клиент на том же ключе и логе использования.
- Все, кто сравнивает региональные и западные модели на реальной ежедневной работе, а не на бенчмарках, где каждый кандидат — одна строка модели.
Проверьте эндпоинт и отладьте первый разговор.
Сначала выполните curl к листингу моделей и скопируйте ID, которые планируете добавить; затем выполните один chat completion против вашей предполагаемой ежедневной модели. Если оба проходят успешно, всё остальное — на странице провайдера. Внутри Cherry Studio запускайте Check перед началом чата. Ошибки аутентификации — это поле ключа или его разделители-запятые. 404 — это форма адреса; читайте составленный URL в ошибке и считайте сегменты /v1. Ошибки not-found на конкретной модели — это написание ID в этой строке. Как только разговоры пойдут, консоль APIsRouter покажет модель на запрос, счётчики токенов и расходы. Десктопный клиент, используемый весь рабочий день, генерирует стабильный поток небольших запросов, и вид использования по ключу превращает этот поток в числа по модели, по дню, с китайскими и западными ID на одной странице.
curl -s https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $APISROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-flash",
"messages":[{"role":"user","content":"ping"}]}'Частые вопросы
Как добавить кастомного провайдера в Cherry Studio?
Значок шестерёнки, вкладка Model Services, Add. Назовите провайдера, выберите тип OpenAI, сохраните, затем на его странице включите его, вставьте свой ключ, задайте API-адрес как https://api.apisrouter.com и добавьте ID моделей вручную. Проверьте кнопкой Check.
Должен ли API-адрес включать /v1?
Нет. Задокументированное поведение Cherry Studio по умолчанию — брать корневой адрес и самостоятельно дописывать /v1/chat/completions, так что вводите https://api.apisrouter.com. Вставка хоста с /v1 удваивает путь и даёт 404. Чтобы закрепить точный нестандартный URL, завершите адрес символом #, отключающим конкатенацию.
Может ли Cherry Studio запускать Claude, DeepSeek и GLM через одного провайдера?
Да. ID каждой строки модели путешествует к адресу как простая строка, так что claude-sonnet-4-6, deepseek-v4-flash, glm-5.2, kimi-k2.6 и qwen3.7-plus могут делить одну запись провайдера и один ключ, переключаемые на каждый разговор и каждого ассистента.
Что делает функция ключей через запятую?
Несколько ключей в поле API-ключа, разделённых английскими запятыми, ротируются сверху вниз по запросам — встроенная функция балансировки нагрузки. При тарификации по ключу на стороне шлюза это также работает как атрибуция; перечислите один ключ, чтобы отключить ротацию.
Почему кнопка Check выдаёт ошибку?
При корректном ключе обычная причина — адрес с лишним /v1, удваивающим составленный путь. При чистом адресе перепроверьте ключ и его разделители; полноширинные запятые из китайских методов ввода тихо ломают списки из нескольких ключей.
Почему модели не заполняются автоматически, как у пресетных провайдеров?
Кастомные провайдеры перечисляют ровно то, что вы добавили; Cherry Studio не получает каталог кастомного эндпоинта. Это держит пикер курируемым. Берите ID из листинга /v1/models и добавляйте те, которые реально используете, расширяя список по мере необходимости.