Разделы базы знаний ▾

Навигация

▸ Начните здесь По ролям

Категории

Инструменты 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 прямо сейчас.

Получить ключ и бесплатные токены →