Додайте кожну модель каталогу в 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 і додайте ті, якими справді користуєтесь, тоді розширте список того дня, коли знадобиться ще один.