Розділи бази знань ▾

Навігація

▸ Почніть тут За ролями

Категорії

Інструменти 52
Глосарій 12

Інструменти

Warp + JoinGonka Gateway — агент терміналу на своєму endpoint

Warp — термінал, що виріс у середовище агентної розробки: вбудований Warp Agent читає вивід команд, править файли, запускає збірки та веде задачу від запиту до результату. За замовчуванням агент працює на моделях, які продає сам Warp, — за кредити тарифу, а принести свій інференс довго можна було лише на платних планах і лише ключем OpenAI, Anthropic або Google. 20 травня 2026 Warp відкрив BYOK на безкоштовному тарифі та додав custom inference endpoint — підключення будь-якого сервісу, що розмовляє на OpenAI Chat Completions.

Другий спосіб і потрібен, щоб пустити агента Warp через JoinGonka Gateway: шлюз віддає моделі децентралізованої мережі Gonka за OpenAI-сумісним API, інференс оплачується за живими цінами мережі, а у одинаків та невеликих команд кредити Warp на нього не витрачаються. Після реєстрації та підтвердження адреси на рахунок прийдуть 3M безкоштовних токенів — їх вистачить, щоб приміряти агента на своїх задачах до першого поповнення.

Нижче — що потрібно до початку, які значення вписати у форму Warp, як переконатися, що запити йдуть через шлюз, яку модель мережі вибрати під термінальні задачі та що важливо знати про маршрут запитів: у Warp він влаштований не так, як у більшості інструментів.

Що знадобиться: ключ, тариф Warp та публічна адреса

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

Тариф Warp. Свій endpoint доступний не тільки на платних планах — умови залежать від розміру команди:

Хто підключаєЧи доступний свій endpointЩо з кредитами Warp
Один розробник або компанія до 10 осіб (плани Free, Build, Max)Так, на будь-якому з цих планівЗа інференс через свій endpoint кредити не списуються
Організація більше 10 осібТільки на Business або EnterpriseЛокальні запуски агента витрачають platform credits — плату за інфраструктуру Warp за зниженою ставкою; сам інференс оплачується провайдеру endpoint

Публічна HTTPS-адреса. Це вимога Warp, про яку легко не здогадатися: запити до вашого endpoint відправляє не додаток на вашій машині, а сервери Warp, тому адреса має бути доступна з інтернету. localhost, 127.0.0.1 та адреси приватних мереж форма відхиляє, а схема допускається лише https://. JoinGonka Gateway — публічний HTTPS-сервіс, тому тунелі на кшталт ngrok, які документація Warp радить для локальних моделей, тут не потрібні.

Свіжа версія додатку. Свій endpoint включений у стабільній збірці з релізу 20 травня 2026, вибір схеми API у формі з'явився у релізі 31 липня 2026. Якщо поля API schema у формі немає — оновіть Warp.

Підключення: форма Add custom endpoint

Усе налаштування робиться в інтерфейсі застосунку — правити файли руками не потрібно.

  1. Відкрийте Settings і наберіть у пошуку налаштувань inference endpoint — Warp перейде до блоку з ключами провайдерів і власними endpoint (він на сторінці налаштувань Warp Agent).
  2. Натисніть Add custom endpoint — відкриється форма.
  3. Заповніть поля значеннями з таблиці та натисніть Add endpoint.
Поле формиЩо вписатиПояснення
API schemaOpenAI Chat CompletionsСхема за замовчуванням: саме для неї документація Warp описує формат адреси. У списку є також OpenAI Responses і Anthropic Messages
Endpoint nameJoinGonkaБудь-яке ім'я — під ним endpoint видно в налаштуваннях
Endpoint URLhttps://gate.joingonka.ai/v1Базова адреса разом із /v1 — так само, як у прикладі з документації Warp
API keyjg-your-keyЗберігається лише на пристрої, у системному сховищі ключів
Model namedeepseek-ai/DeepSeek-V4-Flash-0731Точний ідентифікатор моделі, яким його віддає шлюз
Model alias (optional)DeepSeek V4 FlashКоротке ім'я для перемикача моделей

Кнопка + Add model додає наступний рядок. Заведіть одразу всі моделі мережі, щоб потім перемикатися між ними, не повертаючись у налаштування: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 і zai-org/GLM-5.3-Flash. Актуальний список завжди віддає GET https://gate.joingonka.ai/v1/models. Ідентифікатори вписуйте символ за символом: форма перевіряє лише вигляд адреси та заповненість полів, пробного запиту при збереженні вона не робить, тож друкарська помилка в імені моделі спливе вже в діалозі з агентом.

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

Перевірка: чи йдуть запити через шлюз

Виберіть у перемикачі модель свого endpoint і дайте агенту коротке завдання, наприклад: «Покажи п'ять найбільших файлів у поточному каталозі та поясни команду». Агент має запропонувати команду, виконати її з вашого дозволу та прокоментувати вивід.

Тепер відкрийте кабінет шлюзу, розділ «Використання». У блоці «За ключами» біля ключа, заведеного під Warp, з'являться запити та час останнього звернення, у блоці «За моделями» — вибрана модель. Лічильники зростають — отже, інференс іде через JoinGonka Gateway, а не за кредити Warp. Зі свого боку Warp показує витрату токенів прямо в діалозі з агентом — під тими короткими іменами, що ви задали в полі alias.

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

Що видноЩо це означаєЩо зробити
401, Invalid API keyШлюз не розпізнав ключПеревірте, що ключ починається з jg-, вставлений без пробілів і активний у розділі «API-ключі»; якщо є сумніви, створіть новий
404, Invalid URL (POST …)Шлях зібрано із зайвим сегментом; у тексті помилки шлюз показує, куди саме надійшов запитМає вийти /v1/chat/completions. Задвоївся /v1 або в адресу потрапив повний шлях — приведіть Endpoint URL до вигляду з таблиці вище
405 Not Allowed або HTML-сторінка замість відповідіВ адресі пропущено /v1, запит пішов повз APIДопишіть /v1 у кінець адреси
429Модель перевантажена: у пік ємність конкретної моделі в мережі буває вибрана повністюПовторіть за кілька секунд або перемкніться на сусідню модель — саме для цього й варто завести їх усі одразу
Запити проходять, але кредити Warp танутьУ перемикачі вибрано Auto або маршрутизатор моделей Warp, а не модель endpointВиберіть конкретну модель зі свого списку
Форма не приймає адресуWarp вимагає https:// і публічний хостВписуйте адресу шлюзу повністю, починаючи з https://
Модель «не бачить» прикріплену картинкуМоделі мережі текстові: шлюз замінює зображення текстовою позначкоюДля завдань зі скриншотами перемкніться на модель із зором, для команд і коду залишайтеся на моделі мережі
Моделі endpoint немає при хмарному запускуСвій endpoint зберігається локально і на Cloud Agents не поширюєтьсяЗапускайте завдання локальним агентом

Перша відповідь у сесії може прийти із затримкою в кілька секунд: агент надсилає великий системний промпт з описом інструментів, а запит проходить спочатку сервери Warp, а потім вузол мережі. Далі діалог іде швидше.

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

Ціна у моделей мережі однакова, тому вибір — про поведінку, а не про бюджет. Термінальний агент багато читає (вивід команд, логи, файли) і постійно викликає інструменти; всі моделі з таблиці підтримують нативний tool calling.

МодельІдентифікаторКонтекст і відповідьКоли брати у Warp
DeepSeek V4 Flashdeepseek-ai/DeepSeek-V4-Flash-0731380K, відповідь до 32768 токенівМодель за замовчуванням для агента: довгі сесії, великі логи та діфи, правки в декількох файлах. Запас за контекстом і найбільша стеля відповіді в мережі
MiniMax M2.7MiniMaxAI/MiniMax-M2.7200K, відповідь до 8192 токенівШвидкі короткі завдання: підібрати команду, розібрати помилку, поправити конфіг
GLM-5.3 Flashzai-org/GLM-5.3-Flash390K, відповідь до 8192 токенівReasoning-модель: розмірковує перед відповіддю. Заплутане налагодження, план міграції, розбір незнайомого коду; відповідь приходить пізніше, і частина ліміту відповіді йде на розмірковування

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

Скільки це коштує

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

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

СценарійВитратаЧерез Gateway
Разове завдання: команда та розбір її виводудесятки тисяч токенівчастки цента
День активної роботи з агентом3-7M токенівкілька центів
Місяць щоденної роботи~150M токенівпорядку одного-двох доларів

Для порівняння — три способи оплачувати агента Warp:

СпосібХто рахує інференсЩо обмежує
Моделі WarpWarp, кредитами тарифуМісячний запас кредитів плану
BYOK: ключ OpenAI, Anthropic або GoogleВендор моделі за своїм прайсомЦіна за мільйон токенів у вендора
Свій endpoint + JoinGonka GatewayШлюз: за токенами, з балансуТільки баланс: витрата видно в кабінеті, квот на кількість запитів немає

Сам Warp для одинаків та команд до 10 осіб за роботу через свій endpoint кредитів не бере — платіть тільки за токени на шлюзі. Баланс поповнюється в кабінеті, там же видно залишок і витрату за днями та моделями.

Маршрут запитів і приватність: що важливо знати

У більшості інструментів власний endpoint означає «запити йдуть з моєї машини прямо до провайдера». У Warp інакше: виконуюча частина агента працює на серверах Warp, і власний endpoint змінює лише кінцевого адресата та ключ. Згідно з документацією Warp, шлях запиту такий:

  1. Застосунок бере адресу endpoint і ключ із захищеного сховища на пристрої та відправляє їх на сервери Warp разом із вашим промптом.
  2. Агент на стороні Warp збирає повний запит — системні інструкції, контекст діалогу, інструменти — і викликає ваш endpoint із цим ключем.
  3. Відповідь повертається до застосунку потоком через ті самі сервери.

Що з цього випливає на практиці:

  • Ключ. Зберігається лише на пристрої. Через сервери Warp він проходить під час кожного запиту, але, за заявою Warp, там не зберігається: використовується «на льоту» і відкидається.
  • Промпти та відповіді. Йдуть транзитом через бекенд Warp. Warp заявляє, що не використовує цей вміст для навчання, а зберігання та аналітика підпорядковуються налаштуванням приватності та телеметрії вашого акаунту. Гарантію ZDR, яка діє для моделей самого Warp, на власний endpoint він поширити не може: що зберігає провайдер, визначає провайдер.
  • Сторона шлюзу. JoinGonka Gateway діалоги не зберігає: промпти та відповіді не залишаються на шлюзі після відповіді, у кабінеті видно лише лічильники запитів і токенів.
  • Що залишається на інфраструктурі Warp. Варіанти Auto, користувацькі маршрутизатори моделей, Codebase Context, підказки Active AI та хмарні агенти — на них власний endpoint не впливає.

Якщо для ваших завдань шлях через чужі сервери є неприйнятним, візьміть агента, який ходить до endpoint безпосередньо з вашої машини, — наприклад, Codex CLI або будь-який інструмент із швидкого старту по API. Сам Warp в анонсі обіцяє і клієнтський варіант: легкий агентний модуль на Rust у відкритому репозиторії, який підключатиметься до локальних моделей без маршруту через сервери Warp, і підтримку Agent Client Protocol. А з релізу 2 вересня 2026 описи endpoint зберігаються у файлі налаштувань у форматі, спільному для застосунку та Warp Agent CLI; ключі до цього файлу не потрапляють і залишаються в захищеному сховищі.

Warp підключається до JoinGonka Gateway через форму Add custom endpoint: схема OpenAI Chat Completions, адреса https://gate.joingonka.ai/v1, ключ jg- та ідентифікатори моделей мережі. Одинакам та командам до 10 осіб це доступно навіть на безкоштовному тарифі, і кредити Warp на інференс не витрачаються — якщо в перемикачі обрана модель endpoint, а не Auto. Головна особливість Warp — маршрут: запити до endpoint відправляють його сервери, тому адреса має бути публічною, а промпти проходять через бекенд Warp транзитом. Для термінальних завдань беріть DeepSeek V4 Flash, під дрібниці — MiniMax M2.7, під складну логіку — GLM-5.3 Flash.

Бажаєте дізнатися більше?

Вивчіть інші розділи або почніть заробляти GNK прямо зараз.

Отримати ключ та безкоштовні токени →