Підключіть Cherry Studio до CheapTokens: власний провайдер, Base URL

Щоб використовувати CheapTokens у Cherry Studio, додайте власного провайдера (Settings → Model Provider → Add Provider), вставте https://api.cheaptokens.dev/v1/ у поле OpenAI Base URL, вставте свій API-ключ і додайте ідентифікатор моделі deepseek-ai/DeepSeek-V4-Flash-0731 вручну. Потім перевірте ключ через Model Check і привітайтеся. Це вся робота; єдина деталь, яка кусає, — слеш у кінці URL.

Ви відкриваєте настільний чат-застосунок, бо хочете одне вікно для кількох моделей і один баланс за ними, а не вкладку браузера для кожного сервісу. Cherry Studio саме для цього й створений: це open-source AI-робоча станція для Windows, macOS і Linux (AGPL-3.0 Community Edition) з чатом, агентами та базами знань, і вона приймає будь-який OpenAI-сумісний сервіс як власного провайдера. CheapTokens говорить форматом OpenAI Chat Completions, тож підходить. Кроки нижче відповідають сторінці документації Cherry Studio про власних провайдерів, перевіреній 7 листопада 2026 року; сам застосунок змінюється, тож якщо якийсь напис переїхав, шукайте те саме слово поруч.

Що потрібно перед тим, як відкрити застосунок#

Три речі, усі короткі:

• Base URL: https://api.cheaptokens.dev/v1/ (зі слешем у кінці — причина в наступному розділі);
• API-ключ з вашого акаунта CheapTokens, збережений там, звідки його можна скопіювати, а не вставлений у спільну нотатку;
• повний ідентифікатор моделі. Коротку назву з прайс-листа API не приймає; використовуйте ідентифікатор шлюзу, наприклад deepseek-ai/DeepSeek-V4-Flash-0731. Інші ідентифікатори є в посібнику зі списку моделей і в документації CheapTokens.

Додайте власного провайдера#

Відкрийте Settings (іконка шестерні), потім Model Provider. Унизу списку провайдерів є + Add Provider. Натисніть його, і з'явиться діалог Add Custom Provider.

Заповніть його так:

Cherry Studio за замовчуванням показує поля для ендпоінтів 'OpenAI' та 'Anthropic'. Заповнюйте лише той протокол, який справді використовуєте; для звичайного чату це OpenAI, а поле Anthropic може залишатися порожнім. Під кожним полем Base URL застосунок показує попередній перегляд фінального шляху запиту. Прочитайте його. Це найшвидший спосіб зловити неправильну адресу, перш ніж щось надіслати.

Натисніть Add, щоб зберегти.

Чому слеш у кінці важливий#

Cherry Studio будує URL запиту з вашого Base URL за трьома правилами зі своєї документації (перевірено 7 листопада 2026 року):

• до кореневої адреси, як-от https://example.com, додається /v1/chat/completions;
• до адреси, що закінчується на /, додається лише chat/completions;
• адреса, що закінчується на #, використовується точно як введена, без жодних доповнень.

CheapTokens живе за /v1, тож https://api.cheaptokens.dev/v1/ — це форма, яка перетворюється на https://api.cheaptokens.dev/v1/chat/completions — шлях, якого очікує API. Попередній перегляд під полем має показувати саме це. Якщо ви бачите /v1/v1/ або взагалі немає /v1, виправте поле, перш ніж іти далі.

Ключ, модель і Model Check#

Повернувшись на сторінку провайдера, маємо п'ять маленьких кроків. Виконайте їх у такому порядку:

Примітка до кроку 5. На сторінці також є кнопка Sync models, яка отримує список моделей від сервісу. Надійний шлях — додати ідентифікатор самостійно кнопкою +: введіть deepseek-ai/DeepSeek-V4-Flash-0731 точно, разом із частиною deepseek-ai/. Які моделі можна додати:

Model Check — це кнопка поруч із полем ключа; згідно з документацією Cherry Studio, вона перевіряє, що ключ дійсний. Якщо вона скаржиться, переходьте до розділу про помилки нижче: причина зазвичай в одному з трьох полів.

Надішліть перше повідомлення#

Відкрийте новий чат, виберіть провайдера CheapTokens і модель, яку ви додали, у селекторі моделей угорі та напишіть щось коротке, наприклад 'Поясни, що таке токен, у двох реченнях.' Відповідь від моделі означає, що весь ланцюжок працює: ключ, адреса, ідентифікатор моделі.

Хочете побачити запит без застосунку? Ось звичайний виклик Chat Completions:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

Відповідь — це JSON із текстом у choices[0].message.content і кількістю токенів у usage.

Яку модель вибрати для настільного чату#

Вікно чату — це інша робота, ніж цикл агента: ви питаєте, читаєте, питаєте знову. Тоді важливі дві речі: наскільки довгими можуть бути відповіді та наскільки велика розмова вміщається.

• DeepSeek-V4-Flash — типовий вибір для загального чату й довгих документів: до 32,768 вихідних токенів на відповідь, контекст 380K, одна ціна будь-якої години. Загалом, з урахуванням входу й виходу разом, це дешевше за OpenRouter.
• GLM-5.3-Flash — повсякденний чат із найбільшим вікном із трьох (390K), дешевше за OpenRouter і на вході, і на виході.
• MiniMax-M2.7 — чат і задачі в стилі агента з контекстом 180K, дешевше за OpenRouter з обох боків.

Усі три стоять за одним балансом, тож ви можете додати всі три ідентифікатори до одного провайдера й перемикатися в селекторі моделей, не торкаючись ключа.

Скільки коштує сесія чату#

Ось приблизна картина. Скажімо, у вас розмова на 20 повідомлень. Кожне повідомлення надсилає попередню історію заново, тож запит у середньому становить близько 6,000 токенів на вході та 500 токенів на виході (причина розкрита в чому довгий чат коштує дорожче). Один запит на DeepSeek-V4-Flash коштує $0.00014. Двадцять таких — у калькуляторі нижче; посувайте повзунки, щоб відповідати вашим власним чатам.

Таблиця нижче проганяє ту саму сесію на всіх моделях, зі стовпцем OpenRouter для порівняння:

Актуальні ціни за 1M токенів дивіться в цінах CheapTokens.

Якщо не працює#

Більшість проблем походять із тих самих трьох полів: ключ, URL, ідентифікатор моделі. Зіставте те, що бачите, з причиною:

Докладніший розбір цих помилок дивіться в API 401 або 404: неправильний ключ, base URL чи ідентифікатор моделі. А якщо ви віддаєте перевагу чату в браузері замість настільного застосунку, Open WebUI працює так само.

Джерела: документація Cherry Studio, сторінки про власного провайдера та налаштування провайдера, перевірено 7 листопада 2026 року; проєкт на github.com/CherryHQ/cherry-studio.