Додайте кожну модель каталогу в 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 як тип провайдера, тоді збережіть. Тепер оберіть нового провайдера в списку і налаштуйте його: увімкніть перемикач enable, вставте ваш ключ у поле API key і встановіть 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, приблизно 49 тис. зірок) — десктопний клієнт китайського походження для 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 key приймає більше одного ключа: розділяйте ключі англійськими комами, і 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, для цього існує форма з кінцевим #. Провалена перевірка з хорошим ключем зазвичай через форму адреси вище; провалена перевірка з чистою адресою — це ключ, і зауважте, що кілька ключів мають розділятись англійськими комами, оскільки повноширинні символи, вставлені з китайських методів введення, тихо ламають список. Моделі, що видають помилки окремо, тоді як інші працюють, — це проблема написання 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. Помилки «не знайдено» для конкретної моделі — це написання 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 key, розділених англійськими комами, ротуються зверху вниз між запитами — вбудована функція балансування навантаження. З вимірюванням за ключем на боці шлюзу вона також працює як атрибуція; перелічіть один ключ, щоб тримати ротацію вимкненою.

Чому кнопка Check провалюється?

З правильним ключем звичайна причина — адреса, що несе зайвий /v1, який подвоює складений шлях. З чистою адресою перевірте ключ і його роздільники; повноширинні коми з китайських методів введення тихо ламають списки з кількома ключами.

Чому моделі не заповнюються автоматично, як у пресетних провайдерів?

Кастомні провайдери перелічують точно те, що ви додали; Cherry Studio не отримує каталог кастомного ендпоінта. Це тримає пікер курованим. Витягніть ID зі списку /v1/models і додайте ті, якими справді користуєтесь, тоді розширте список того дня, коли знадобиться ще один.