दस्तावेज़

त्वरित शुरुआत

JoinGonka Gateway Gonka मॉडल तक पहुँचने के लिए OpenAI और Anthropic API का समर्थन करता है। बदलें base_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?"}
    ]
  }'

स्ट्रीमिंग (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)

टूल उपयोग (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 प्रारूप (स्ट्रीमिंग समर्थित)

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 प्रारूप (स्ट्रीमिंग, टूल_उपयोग)

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 क्षमताओं का विस्तार करते हैं। सक्रिय करने के लिए अनुरोध में प्लगइन्स की एक सरणी पास करें।

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 – प्लगइन्स सरणी में वेब ऑब्जेक्ट (विकल्पों के साथ परिणाम इंजेक्शन):

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 — परिणामों से पहले आपका अपना ग्राउंडिंग प्रॉम्ट (grounding 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") — लूप के सभी चरणों के टोकन और प्रत्येक web_search कॉल के लिए 1000 nGNK का अतिरिक्त शुल्क (GNK के प्रति दर ~$0.15 पर 1000 खोजों के लिए ≈ $0.0001)।

privacy-sanitization के साथ असंगत: संयुक्त अनुरोध 400 प्रतिक्रिया लौटाएगा।

response-healing

कटे हुए JSON/संरचित आउटपुट की स्वचालित मरम्मत। केवल JSON सामग्री वाले गैर-स्ट्रीमिंग अनुरोधों के लिए काम करता है।

privacy-sanitization

मॉडल को भेजे जाने से पहले संदेशों में संवेदनशील डेटा (API कुंजियाँ, ईमेल, IP पते, JWT, कार्ड नंबर) को मास्क करना।

मोड: redact ( [REDACTED] से बदलना) या tokenize ( [TOKEN_001] से बदलना)। बॉडी में privacy_mode पास करें।

file-parser

PDF दस्तावेज़ों से टेक्स्ट निकालना। data:application/pdf;base64,... और रॉ base64 का समर्थन करता है।

प्रबंध कुंजी

SaaS एकीकरण के लिए पदानुक्रमित API कुंजियाँ। प्रबंध कुंजी (gm-) सीमाओं और TTL के साथ चाइल्ड कुंजियाँ (gc-) बनाती है।

POST/api/management/keys

एक प्रबंध कुंजी बनाएँ (उपसर्ग gm-)। इसका उपयोग केवल चाइल्ड कुंजियों के प्रबंधन के लिए किया जाता है।

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

वैकल्पिक सीमाओं के साथ एक चाइल्ड कुंजी (उपसर्ग gc-) बनाएँ। बिलिंग प्रबंध कुंजी के मालिक के खाते से काटी जाती है।

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

उपयोग आँकड़ों के साथ चाइल्ड कुंजियों की सूची।

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

चाइल्ड कुंजी की सीमाएँ, RPM या स्थिति अद्यतन करें।

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

चाइल्ड कुंजी को निष्क्रिय करें (सॉफ्ट डिलीट)।

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

जब स्ट्रीम: सही हो, तो प्रतिक्रिया SSE (सर्वर-सेंट इवेंट्स) के माध्यम से खंडों में आती है।

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 अनुरोध द्वारा प्राप्त की जा सकती है। मॉडल चुनने के लिए — अनुरोध बॉडी के model फ़ील्ड में उसका ID पास करें।

मॉडल	विक्रेता	संदर्भ	अधिकतम आउटपुट	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। विज़न और मल्टीमॉडल इनपुट (image_url) अभी तक अपस्ट्रीम गोंका नेटवर्क द्वारा समर्थित नहीं हैं।

दरें और शुल्क

पूर्ण पारदर्शिता: नीचे सभी gateway शुल्क दिए गए हैं। वास्तविक मानों को API से लाइव लोड किया जाता है — सार्वजनिक एंडपॉइंट GET /api/pricing बिना प्रमाणन के उपलब्ध है।

ऑपरेशन	शुल्क	टिप्पणी
इन्फरेंस पर अतिरिक्त शुल्क	10%	Gonka नेटवर्क मूल्य से ऊपर प्लेटफ़ॉर्म का अतिरिक्त शुल्क — gateway राजस्व का मुख्य स्रोत। टोकन की लागत के साथ प्रत्येक अनुरोध से काटा जाता है।
USDT के माध्यम से टॉप-अप	5%	क्रिप्टो (USDT) के साथ भुगतान करने पर भुगतान प्रदाता द्वारा रोक लिया जाता है।
GNK के माध्यम से टॉप-अप	मुफ़्त	सीधा GNK on-chain स्थानांतरण बिना gateway शुल्क के जमा किया जाता है।
निकासी	5%	बाहरी पते पर GNK निकालते समय काटा जाता है। निकासी को 24-48 घंटों के भीतर मैन्युअल रूप से संसाधित किया जाता है।
वर्तमान GNK मूल्य	$0.147	GNK/USD दर जिस पर जमा और शेष राशि की गणना की जाती है। स्वचालित रूप से अपडेट किया जाता है।

GET /api/pricing

सीमाएं

मॉडल: सभी Gonka नेटवर्क मॉडल (देवशार्ड्स मल्टी-मॉडल आर्किटेक्चर)

अनुरोध सीमा: API कुंजी के साथ अनुरोधों की संख्या निश्चित रूप से सीमित नहीं है (नेटवर्क समवर्तीता को सीमित करती है); कुंजी के बिना — 20/दिन प्रति IP (स्पैम-विरोधी)

अधिकतम टोकन: DeepSeek V4 Flash के लिए प्रति अनुरोध 32,768 टोकन तक और अन्य मॉडल के लिए 8,192 तक (सीमा से अधिक मानों को gateway द्वारा काट दिया जाता है)। लंबे उत्तरों के लिए, टाइमआउट से बचने के लिए stream:true का उपयोग करें।

स्ट्रीमिंग: समर्थित (SSE, stream: true)

नेटवर्क टाइमआउट: यदि Gonka नेटवर्क ने अनुरोध स्वीकार कर लिया है लेकिन 300 सेकंड के भीतर जवाब नहीं दिया है, तो अनुरोध 504 त्रुटि के साथ समाप्त हो जाता है, और प्रॉम्प्ट प्रोसेसिंग अनुमान के आधार पर काट ली जाती है: नेटवर्क द्वारा स्वीकार किया गया अनुरोध रद्द नहीं किया जा सकता, नोड इसे किसी भी स्थिति में प्रोसेस करता है। टाइमआउट होने पर Completion के लिए शुल्क नहीं लिया जाता है। लंबी जेनरेशन के लिए stream:true का उपयोग करें।