Telegram
RU
Портал сообщества Gonka — создан и поддерживается участниками сообщества
← На главную

Gonka API — подключиться и попробовать

Инференс для агентов, кода и фоновых задач. Три способа подключиться к моделям сети — от готового API до собственного Gateway.

DeepSeek V4 Flash · MiniMax M2.7 · GLM 5.3 Flash
01 / Самый простой старт

Получите ключ. Подключите API.

  1. 01

    Выберите брокера

    Зарегистрируйтесь на его сайте и получите API-ключ.

  2. 02

    Вставьте настройки

    Укажите Base URL, ключ этого брокера и точный Model ID в своём инструменте.

  3. 03

    Используйте инференс

    Запускайте агента, автоматизацию или первый запрос.

В привычных инструментах

Cursor Cline Roo Code Kilo Code Continue Aider OpenCode Zed OpenClaw Claude Code
API / PLAYGROUND

Один API — для ваших задач

Попробуйте модель прямо здесь — без регистрации и API-ключа. Для своих скриптов, агентов и фоновых задач подключите API выбранного брокера.

Пример первого запроса · Python
import json, os
from urllib.request import Request, urlopen

request = Request(
    os.environ["GONKA_BASE_URL"] + "/chat/completions",
    headers={
        "Authorization": "Bearer " + os.environ["GONKA_API_KEY"],
        "Content-Type": "application/json",
    },
    data=json.dumps({
        "model": os.environ["GONKA_MODEL"],
        "messages": [{"role": "user", "content": "Hello, Gonka!"}],
    }).encode(),
)
with urlopen(request) as response:
    print(json.load(response)["choices"][0]["message"]["content"])
gonka.network~/inference

›

02 / Оплата в GNK

OpenBroker: сетевой тариф в GNK

Если у вас есть GNK и вы хотите подключить свои приложения или выдавать ключи пользователям, OpenBroker берёт на себя Gateway и devshards.

0%Наценка на инференс
GNKОплата нативным токеном
APIПодключение приложений
  1. 01

    Создайте аккаунт

    Укажите организацию, email и адрес кошелька Gonka.

  2. 02

    Пополните GNK

    Переведите нативный GNK на выданный адрес. По текущему quickstart активация — от 100 GNK; сверяйте порог в документации.

  3. 03

    Выпустите ключ

    После активации создайте obk-ключ в панели.

  4. 04

    Подключите приложение

    Укажите endpoint, ключ и модель — свой Gateway запускать не нужно.

По документации OpenBroker, наценка составляет 0%: оплачивается стоимость работы сети, включая повторные попытки. Это позволяет избежать брокерской наценки, но итоговый расход зависит от токенов и выполнения запроса.

Allowlist-кошелёк, escrows и Gateway обслуживает OpenBroker. Ключи ваших приложений создаёте вы.

Открыть OpenBroker Шаги подключения Как считается стоимость
Base URL
03 / ADVANCED

Свой Gateway и devshards

Для тех, кому нужны собственные ключи escrow, управление сессиями и прямые расчёты с сетью. Инфраструктуру и её работу контролируете вы.

  1. 01

    Доступ через governance

    Адрес создателя escrow должен попасть в on-chain allowlist. Его меняют голосованием хостов. Заявка сама по себе не даёт доступ.

  2. 02

    Свой сервер и ключи

    Запустите Gateway на своей машине, настройте доступ и пополните выделенный кошелёк GNK.

  3. 03

    Управление devshards

    Открывайте сессии, направляйте запросы, управляйте ротацией и завершайте расчёты с сетью.

Devshard — сессия инференса с депозитом в сети и учётом выполненных запросов. Gateway управляет её жизненным циклом; это не отдельная модель и не GPU-нода.

Почему доступ пока ограничен?

Прямой доступ к devshards влияет на работу и учёт запросов сети. Пока сеть развивает защиту этого механизма, безопасность и стабильность опираются в том числе на ограниченный круг операторов. Репутация, вклад и понятный сценарий использования помогают сообществу оценить заявку; окончательное решение — за governance.

Свободный доступ — ожидаемое направление развития. Фиксированной даты снятия allowlist в текущей документации нет; 2027 год пока нельзя считать гарантированным сроком.

Официальный гайд Gateway Как запросить доступ

Перед первым запросом

Нужен ли GNK для старта?

Через обычного брокера — не обязательно: доступные способы оплаты и бонусы зависят от сервиса. OpenBroker и собственный Gateway используют нативный GNK.

Какие модели доступны?

Каталог меняется. Возьмите точный Model ID у выбранного провайдера; наличие модели в списке не гарантирует свободную мощность прямо сейчас.

Нужен ли ключ для демо?

Нет, демо оплачивает GNK Space. Если достигнут лимит или модель недоступна, попробуйте позже. Для работы в своей IDE или приложении получите личный ключ у брокера.

Это только для чата?

Нет. API подходит для агентов, обработки текста и фоновых задач. Поддержку конкретных функций, включая tool calling, проверяйте у брокера и модели.

Подробнее для разработчиков →Кошельки GNK →