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

Швидкий старт

Джойгонка 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)

Джойгонка 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 (префікс gm-). Використовується лише для керування child keys.

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

Створити child key (префікс 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 зі статистикою використання.

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 та до 8 192 для інших моделей (значення, що перевищують ліміт, обрізаються шлюзом gateway). Для довгих відповідей використовуйте stream:true, щоб уникнути тайм-аутів.

Стрімінг: підтримується (SSE, stream: true)

Таймаут мережі: Якщо мережа Gonka прийняла запит, але не відповіла протягом 300 секунд, запит завершується помилкою 504, а обробка запиту (промпта) списується за оцінкою: запит, прийнятий мережею, не можна скасувати, нода обробляє його в будь-якому випадку. Completion при таймауті не тарифікується. Для довгих генерацій використовуйте stream:true.