Cherry Studio + JoinGonka Gateway — настільний AI-клієнт

Встановлення. Збірки для всіх систем лежать на сторінці релізів проєкту: інсталятор і портативна збірка для Windows, образ dmg для macOS, AppImage, deb і rpm для Linux — під x64 і ARM. Історія діалогів і налаштування зберігаються локально, на вашій машині.

V1 чи V2. У серпні 2026 вийшла лінійка V2 з новим устроєм даних і переробленими налаштуваннями; остання збірка попередньої лінійки — 1.9.13. Свій провайдер є в обох, відрізняються форма додавання і частина підписів — нижче такі місця позначені. При переході з V1 налаштування провайдерів і моделі переносяться автоматично, вихідні дані V1 зберігаються, але назад нові дані не синхронізуються, а резервні копії двох лінійок несумісні. Перед оновленням прочитайте розділ про міграцію в документації Cherry Studio.

Ключ JoinGonka. Зареєструйтесь на шлюзі, відкрийте в кабінеті розділ «API-ключі» і натисніть «Створити ключ». Ключ починається з jg- і показується один раз — збережіть його одразу. Зручно завести під Cherry Studio окремий ключ: у розділі «Використання» його витрату буде видно окремим рядком.

1. Натисніть значок шестерні — відкриються налаштування. Виберіть розділ Model Provider (в англійській документації він називається Model Services).
2. Під списком провайдерів натисніть Add Provider.
3. У V2 відкриється діалог Add Custom Provider. Впишіть Provider Name — наприклад, JoinGonka. У блоці Endpoint settings заповніть рядок OpenAI адресою https://gate.joingonka.ai/v1: під полем з'явиться рядок Request path з підсумковим шляхом — він має закінчуватися на /v1/chat/completions. У полі API Key вставте jg-your-key і натисніть Add.
4. У V1 діалог коротший: ім'я провайдера та Provider Type — виберіть OpenAI. Ключ і адреса вводяться вже на сторінці провайдера, у полях API Key та API Host.
5. Переконайтеся, що провайдер увімкнений: перемикач розташований у правому верхньому куті його сторінки. У V2 нові провайдери додаються вимкненими, а моделі вимкненого провайдера у списках вибору не з'являються.

Як Cherry Studio збирає адресу. Поле API Host приймає базову адресу, а шлях застосунок дописує сам і показує результат у рядку Preview під полем. Правила однакові в обох лінійках:

У старих інструкціях трапляється ще одне правило: слеш у кінці адреси нібито вимикає /v1. Воно діяло в ранніх версіях, до лінійки 1.6 включно, і прибране в 1.7: в актуальних збірках автопідстановку вимикає лише #.

Провайдер доданий, але в чаті його поки не видно: у списки вибору Cherry Studio потрапляють лише моделі, які ви додали явно. Способів два.

Список із сервера. На сторінці провайдера натисніть Sync models (у V1 — Manage, потім Fetch model list). Cherry Studio запитає у шлюзу GET /v1/models і покаже живий склад мережі; додайте потрібні моделі кнопкою +. Вручну. Кнопка Add Model відкриває форму, де обов'язкове одне поле — Model ID: ідентифікатор вписується символ у символ.

Ціна у моделей мережі однакова, тому додавайте всі — вибирати між ними доведеться за поведінкою, а не за бюджетом:

Типи моделі. У кожної моделі у списку є кнопка налаштувань, де позначаються її можливості: Vision, Reasoning, Tool та інші. Частину позначок Cherry Studio ставить автоматично, але для моделей шлюзу їх варто перевірити. Vision має бути знятий: моделі мережі текстові. Tool потрібен, якщо ви підключаєте MCP-інструменти, — нативний виклик інструментів підтримують усі моделі з таблиці. Reasoning доречний у GLM-5.3 Flash — це reasoning-модель мережі.

Модель за замовчуванням. У розділі налаштувань Default Model задаються моделі для службових ролей. Основною моделлю асистента поставте DeepSeek V4 Flash. Для швидкої моделі, яка вигадує назви діалогам і готує пошукові запити, документація Cherry Studio радить легку і швидку модель, не reasoning, — із моделей мережі на цю роль найкраще підходить MiniMax M2.7, а GLM-5.3 Flash з її обов'язковими міркуваннями сюди не ставте. Для перекладу підійде будь-яка з перших двох.

На сторінці провайдера в блоці ключа є кнопка Model Check (у V1 — Check поруч із полем ключа). Виберіть модель — Cherry Studio відправить їй короткий пробний запит і покаже результат разом із затримкою відповіді. Перевірку пройдено — переходьте в чат, виберіть модель шлюзу в перемикачі моделей і задайте будь-яке запитання.

Щоб переконатися, що запити йдуть саме через шлюз, відкрийте його кабінет, розділ «Використання»: у блоці «За ключами» у ключа Cherry Studio з'являться запити та час останнього звернення, у блоці «За моделями» — вибрана модель. У V2 є і власна статистика клієнта, розділ налаштувань Usage: токени та запити за провайдерами, моделями та ключами. Вартість там довідкова — Cherry Studio оцінює її за публічними прайсами моделей, а не за ціною мережі Gonka, тому точні суми дивіться в кабінеті шлюзу.

Якщо щось пішло не так, причина майже завжди читається по відповіді:

Сам клієнт розповсюджується вільно, платите ви тільки за інференс. Через JoinGonka Gateway токени коштують $0.0069 за мільйон на вході та $0.021 за мільйон на виході — ціна однакова для всіх моделей мережі й підставляється на цій сторінці з живого джерела. Чат витрачає токени помітно скромніше за агентні інструменти, тому порядок сум за цінами на вересень 2026 такий:

Важливе застереження про довгі діалоги: з кожною реплікою клієнт відправляє моделі всю історію заново, тому сота репліка коштує дорожче за першу. Ліки — новий діалог під нове завдання; у Cherry Studio це одна кнопка.

Порівняння моделей в одному діалозі. Cherry Studio вміє поставити одне питання кільком моделям одразу: виберіть їх у перемикачі моделей, і кожна відповість окремим запитом. При єдиній ціні на всі моделі мережі це найшвидший спосіб зрозуміти на своїх завданнях, де вистачає MiniMax M2.7, де потрібна довга відповідь DeepSeek V4 Flash, а де окупаються міркування GLM-5.3 Flash — її налаштування розібрані в огляді моделі.

Другий протокол тим самим ключем. Шлюз відповідає і у форматі Anthropic. У діалозі V2 для нього є окремий рядок Anthropic у блоці Endpoint settings: впишіть туди https://gate.joingonka.ai, і в рядку Request path має вийти шлях /v1/messages. У V1 той самий результат дає окремий провайдер з Provider Type Anthropic і тією самою адресою. Під кнопкою More options у V2 є і рядок OpenAI Responses — його шлюз теж обслуговує, адреса та сама, що у основного рядка OpenAI.

Запуск термінальних агентів. На сторінці Code CLI (у документації — Coding Companion) Cherry Studio встановлює і запускає консольних агентів, підставляючи їм провайдера і модель зі своїх налаштувань; список провайдерів там фільтрується за протоколом, який потрібен конкретному інструменту. Тому Anthropic-адресу варто заповнити заздалегідь, якщо збираєтеся запускати звідси Claude Code. Як той самий агент налаштовується без посередників — у гайді Claude Code + Gonka.

База знань. У V2 вона працює і без ембеддинг-моделі — на текстовому пошуку BM25, а з ембеддинг-моделлю вмикається гібридний пошук. Моделі мережі Gonka — генеративні, тому для гібридного режиму візьміть ембеддинг-модель в іншого провайдера, наприклад локальну через Ollama; відповідати за знайденими фрагментами при цьому буде модель шлюзу.

Потрібен спільний чат для команди в браузері? Cherry Studio — особистий настільний клієнт. Для спільного веб-інтерфейсу з обліковими записами подивіться Open WebUI: він підключається до шлюзу тією ж адресою і ключем.