Документация

Быстрый старт

JoinGonka Gateway поддерживает OpenAI и Anthropic API для доступа к моделям Gonka. Замените base_url в вашем клиенте — и всё работает.

Базовый URL: https://gate.joingonka.ai/v1

Модель: MiniMaxAI/MiniMax-M2.7

Авторизация: Bearer YOUR_API_KEY

Python (OpenAI SDK)

python

from openai import OpenAI

client = OpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key="YOUR_API_KEY",
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "What is Gonka?"},
    ],
    temperature=0.7,
    max_tokens=1024,
)

print(response.choices[0].message.content)

TypeScript (OpenAI SDK)

typescript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gate.joingonka.ai/v1",
  apiKey: "YOUR_API_KEY",
});

const response = await client.chat.completions.create({
  model: "MiniMaxAI/MiniMax-M2.7",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "What is Gonka?" },
  ],
  temperature: 0.7,
  max_tokens: 1024,
});

console.log(response.choices[0].message.content);

cURL

bash

curl https://gate.joingonka.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is Gonka?"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

Anthropic API (Claude Code)

JoinGonka Gateway нативно поддерживает Anthropic Messages API (/v1/messages). Claude Code, Anthropic SDK и любые инструменты, использующие Anthropic формат, работают напрямую — без прокси.

Claude Code

Recommended — set it up with one command (also configures OpenClaw and Cline):

bash

npx @joingonka/setup

Or configure it manually:

bash

export ANTHROPIC_BASE_URL=https://gate.joingonka.ai
export ANTHROPIC_API_KEY=YOUR_API_KEY
claude

Python (Anthropic SDK)

python

import anthropic

client = anthropic.Anthropic(
    base_url="https://gate.joingonka.ai",
    api_key="YOUR_API_KEY",
)

message = client.messages.create(
    model="MiniMaxAI/MiniMax-M2.7",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "What is Gonka?"},
    ],
)

print(message.content[0].text)

cURL (Anthropic format)

bash

curl https://gate.joingonka.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "What is Gonka?"}
    ]
  }'

Streaming (Python)

python

import anthropic

client = anthropic.Anthropic(
    base_url="https://gate.joingonka.ai",
    api_key="YOUR_API_KEY",
)

with client.messages.stream(
    model="MiniMaxAI/MiniMax-M2.7",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain Gonka"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Tool Use (cURL)

bash

curl https://gate.joingonka.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "max_tokens": 1024,
    "tools": [{
      "name": "get_weather",
      "description": "Get current weather",
      "input_schema": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"]
      }
    }],
    "messages": [{"role": "user", "content": "Weather in Moscow?"}]
  }'

Оба формата (OpenAI и Anthropic) используют один API-ключ и один баланс.

API-эндпоинты

Inference

POST/v1/chat/completions

Генерация ответа — OpenAI формат (streaming поддерживается)

json

{
  "id": "chatcmpl-abc123...",
  "object": "chat.completion",
  "model": "MiniMaxAI/MiniMax-M2.7",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you?",
      "tool_calls": []
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 8,
    "total_tokens": 20
  },
  "x_joingonka": {
    "cost_ngonka": "24",
    "balance_ngonka": "11999976"
  }
}

POST/v1/messages

Генерация ответа — Anthropic формат (streaming, tool_use)

json

{
  "id": "msg_abc123...",
  "type": "message",
  "role": "assistant",
  "content": [{"type": "text", "text": "Hello!"}],
  "model": "MiniMaxAI/MiniMax-M2.7",
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 12, "output_tokens": 8}
}

GET/v1/models

Список доступных моделей

json

{
  "object": "list",
  "data": [{
    "id": "MiniMaxAI/MiniMax-M2.7",
    "object": "model",
    "owned_by": "gonka-network",
    "context_length": 200000,
    "pricing": {
      "prompt": "0.00000007",
      "completion": "0.0000001"
    },
    "architecture": {
      "modality": "text->text"
    },
    "top_provider": {
      "context_length": 200000,
      "max_completion_tokens": 8192,
      "is_moderated": false
    },
    "supported_parameters": [
      "temperature", "top_p", "tools",
      "tool_choice", "max_tokens", "stop"
    ],
    "x_gonka": {
      "v_ram": 320,
      "context_window": 200000,
      "max_output": 8192,
      "actual_cost_ngonka": 1.2
    }
  }]
}

Плагины

Плагины расширяют возможности API. Передайте массив plugins в запросе для активации.

GET/v1/plugins

Список доступных плагинов

json

{
  "plugins": [
    {"id": "web", "description": "Web search — inject fresh results with citations"},
    {"id": "response-healing", "description": "Auto-fix truncated JSON"},
    {"id": "privacy-sanitization", "description": "Mask sensitive data"},
    {"id": "file-parser", "description": "Extract text from PDF"}
  ]
}

Использование в запросе

json

{
  "model": "MiniMaxAI/MiniMax-M2.7",
  "messages": [{"role": "user", "content": "..."}],
  "plugins": ["response-healing", "privacy-sanitization"]
}

web

Веб-поиск прямо в моделях Gonka. У самих моделей (Kimi, MiniMax, DeepSeek) поиска нет — gateway подмешивает свежие результаты из интернета в контекст и возвращает цитаты-источники. Работает в stream и non-stream. Бэкенд собственный (self-hosted): запросы не уходят в сторонние поисковые API под вашим аккаунтом.

Способ 1 — объект web в массиве plugins (инъекция результатов с опциями):

json

{
  "model": "MiniMaxAI/MiniMax-M2.7",
  "messages": [{"role": "user", "content": "What's new in the Gonka network?"}],
  "plugins": [{
    "id": "web",
    "max_results": 5,
    "search_prompt": "Relevant web search results:"
  }]
}

Способ 2 — агентный режим (mode: "agent"): модель сама вызывает web_search только когда нужен поиск:

json

{
  "model": "MiniMaxAI/MiniMax-M2.7",
  "messages": [{"role": "user", "content": "What's new in the Gonka network?"}],
  "plugins": [{ "id": "web", "mode": "agent", "max_searches": 3 }]
}

Опции: max_results — число результатов (по умолчанию 5, потолок 10); search_prompt — свой грундинг-промпт, предваряющий результаты.

Ответ обогащается annotations[].url_citation (url, title) — стандарт OpenRouter:

json

{
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "...",
      "annotations": [{
        "type": "url_citation",
        "url_citation": {
          "url": "https://gonka.ai/...",
          "title": "Gonka Network"
        }
      }]
    }
  }]
}

Тарификация: режим plugins:[{ "id": "web" }] — только за токены (подмешанные результаты идут как обычные prompt-токены). Агентный режим (mode: "agent") — токены всех шагов цикла плюс надбавка 1000 nGNK за каждый вызов web_search (≈ $0.0001 за 1000 поисков по курсу ~$0.15 за GNK).

Несовместимо с privacy-sanitization: совместный запрос вернёт 400.

response-healing

Автоматическая починка обрезанного JSON/structured output. Работает только для non-streaming запросов с JSON-содержимым.

privacy-sanitization

Маскировка чувствительных данных (API-ключи, email, IP-адреса, JWT, номера карт) в messages перед отправкой в модель.

Режимы: redact (замена на [REDACTED]) или tokenize (замена на [TOKEN_001]). Передайте privacy_mode в body.

file-parser

Извлечение текста из PDF-документов. Поддержка data:application/pdf;base64,... и raw base64.

Management Keys

Иерархические API-ключи для SaaS-интеграций. Management key (gm-) создаёт child keys (gc-) с лимитами и TTL.

POST/api/management/keys

Создать management key (prefix gm-). Используется только для управления child keys.

POST/api/management/keys/:id/children

Создать child key (prefix gc-) с опциональными лимитами. Биллинг списывается с баланса владельца management key.

json

{
  "name": "Client A",
  "limit_daily_ngonka": "1000000000",
  "limit_monthly_ngonka": "10000000000",
  "expires_at": "2026-04-01T00:00:00Z",
  "rate_limit_rpm": 30
}

GET/api/management/keys/:id/children

Список child keys с usage-статистикой.

PUT/api/management/keys/:id/children/:childId

Обновить лимиты, RPM или статус child key.

DELETE/api/management/keys/:id/children/:childId

Деактивировать child key (soft delete).

Account

GET/api/balance

Текущий баланс

json

{
  "balance_ngonka": "11999976",
  "balance_usd": 0.008,
  "cost_per_token_ngonka": 1,
  "tokens_remaining": 11999976
}

GET/api/keys

Список API-ключей

POST/api/keys

Создать API-ключ

DELETE/api/keys/:id

Удалить API-ключ

Billing

GET/api/usage

Статистика использования

Query: period=day|week|month&tz=-180

json

{
  "period": "month",
  "usage": [{
    "date": "2026-03-20",
    "requests": 42,
    "tokens": 18500,
    "costNgonka": "22200"
  }]
}

GET/api/deposits

История депозитов

Query: limit=50&offset=0&from=2026-03-01&to=2026-03-21

json

{
  "deposits": [{
    "id": "abc-123",
    "type": "DEPOSIT_GNK",
    "amountNgonka": "10000000",
    "description": "GNK deposit via memo",
    "createdAt": "2026-03-20T12:00:00Z"
  }],
  "total": 3
}

GET/api/transactions

История транзакций

Query: limit=50&offset=0&type=INFERENCE&from=2026-03-01&to=2026-03-21

json

{
  "transactions": [{
    "id": "def-456",
    "type": "INFERENCE",
    "amountNgonka": "-1200",
    "feeNgonka": "120",
    "description": null,
    "createdAt": "2026-03-20T14:30:00Z"
  }],
  "total": 128
}

GET/api/pricing

Тарифы и комиссии (публичный, без авторизации)

json

{
  "deposit_usdt_fee_percent": 5,
  "deposit_gnk_fee_percent": 0,
  "usage_fee_percent": 10,
  "withdrawal_fee_percent": 5,
  "gnk_usd_price": 0.3465
}

Streaming & Errors

При stream: true ответ приходит чанками через SSE (Server-Sent Events).

OpenAI (stream: true)

text

data: {"choices":[{"delta":{"content":"Hello"}}]}

data: {"choices":[{"delta":{"content":"!"}}]}

data: {"choices":[],"x_joingonka":{"cost_ngonka":"24"}}

data: [DONE]

Anthropic (stream: true)

text

event: message_start
data: {"type":"message_start","message":{...}}

event: content_block_delta
data: {"type":"content_block_delta","delta":{"type":"text_delta","text":"Hello"}}

event: message_stop
data: {"type":"message_stop"}

Ошибки

json

// 400 — неверный запрос
{"error": {"message": "...", "type": "invalid_request_error"}}

// 401 — не авторизован
{"error": {"message": "...", "type": "authentication_error"}}

// 402 — недостаточный баланс
{"error": {"message": "...", "type": "insufficient_funds", "balance_ngonka": "0"}}

// 429 — rate limit
{"error": {"message": "...", "type": "rate_limit_error"}}

// 502 — ошибка сети Gonka
{"error": {"message": "...", "type": "api_error"}}

Модели

Сеть Gonka обслуживает несколько моделей через единый API — актуальный список всегда можно получить запросом GET /v1/models. Чтобы выбрать модель — передайте её ID в поле model тела запроса.

Модель	Производитель	Контекст	Макс. вывод	VRAM	Статус
MiniMax M2.7	MiniMax	195K	8K	320 GB	Доступна
Kimi K2.6	Moonshot AI	195K	8K	720 GB	Доступна
DeepSeek V4 Flash	DeepSeek	371K	32K	280 GB	Доступна

По умолчанию (если model не указан) используется флагманская модель сети. Актуальный список с метаданными — GET /v1/models.

Актуальный список моделей со всеми метаданными — GET /v1/models. Vision и multimodal-вход (image_url) пока не поддерживаются upstream сетью Gonka.

Тарифы и комиссии

Полная прозрачность: ниже все комиссии шлюза. Актуальные значения подгружаются вживую из API — публичный эндпоинт GET /api/pricing доступен без авторизации.

Операция	Комиссия	Примечание
Наценка на инференс	10%	Наценка платформы сверх сетевой цены Gonka — основной источник дохода шлюза. Списывается с каждого запроса вместе со стоимостью токенов.
Пополнение через USDT	5%	Удерживается платёжным провайдером при оплате криптой (USDT).
Пополнение через GNK	бесплатно	Прямой перевод GNK on-chain зачисляется без комиссии шлюза.
Вывод средств	5%	Удерживается при выводе GNK на внешний адрес. Вывод обрабатывается вручную в течение 24–48 часов.
Текущая цена GNK	$0.147	Курс GNK/USD, по которому считаются пополнения и баланс. Обновляется автоматически.

GET /api/pricing

Лимиты

Модели: Все модели сети Gonka (мульти-модельная архитектура DevShards)

Лимит запросов: с API-ключом число запросов не лимитируется фиксированно (ограничивает конкурентность сети); без ключа — 20/сутки на IP (анти-спам)

Макс. токенов: до 32 768 токенов на запрос для DeepSeek V4 Flash и до 8192 для остальных моделей (значения сверх лимита gateway клипует). Для длинных ответов используйте stream:true, чтобы избежать таймаутов.

Стриминг: поддерживается (SSE, stream: true)

Таймаут сети: если сеть Gonka приняла запрос, но не ответила за 300 секунд — запрос завершается ошибкой 504, а обработка промпта списывается по оценке: принятый сетью запрос нельзя отменить, нода обрабатывает его в любом случае. Completion при таймауте не тарифицируется. Для длинных генераций используйте stream:true.