AI ایجنٹس کے لیے: سیٹ اپ کی مرحلہ وار ہدایات — /docs/agents.md، دستاویزات کا انڈیکس — /llms.txt۔

Gonka ماڈلز کو اپنے ٹول سے جوڑیں

OpenAI اور Anthropic کے ساتھ مطابقت رکھنے والا API۔ اپنا ٹول منتخب کریں — انسٹال کمانڈ، ایجنٹ کے لیے پرامپٹ اور تصدیق حاصل کریں۔

فوری حقائق#

  • OpenAI API کلائنٹس کے لیے بیس URL: https://gate.joingonka.ai/v1
  • Anthropic API کلائنٹس کے لیے بیس URL، /v1 کے بغیر: https://gate.joingonka.ai
  • کلید Authorization: Bearer jg-… یا x-api-key: jg-… ہیڈر میں بھیجی جاتی ہے
  • دستیاب ماڈلز کی فہرست: GET https://gate.joingonka.ai/v1/models
  • تجویز کردہ ماڈل: MiniMaxAI/MiniMax-M2.7

ٹول جوڑیں#

اپنا ٹول منتخب کریں — نیچے اسی کے لیے تین مراحل ہیں۔ انسٹالر نیچے دیے گئے جدول کے ٹولز (25) ایک کمانڈ میں ترتیب دیتا ہے، باقی گائیڈ کے مطابق جڑتے ہیں۔

Claude Code

  1. کلید

    gate.joingonka.ai پر رجسٹر ہوں اور ڈیش بورڈ میں ایک کلید بنائیں۔ رجسٹریشن کے فوراً بعد اکاؤنٹ میں 3M مفت ٹوکنز آ جاتے ہیں۔

    API کلید حاصل کریں
  2. جوڑنا

    انسٹالر خود Claude Code کو ترتیب دے گا: پوشیدہ ان پٹ میں کلید پوچھے گا، کنفگ لکھے گا اور گیٹ وے پر درخواست بھیج کر کنکشن کی تصدیق کرے گا۔

    Bash
    npx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7

    یا ترتیب دینے کی ذمہ داری AI ایجنٹ کو دیں — اسے یہ پرامپٹ بھیجیں:

    ایجنٹ کے لیے پرامپٹ
    https://gate.joingonka.ai/docs/agents.md کی ہدایات کے مطابق Claude Code کو JoinGonka Gateway سے جوڑیں — یہ Gonka نیٹ ورک کا OpenAI اور Anthropic کے ساتھ مطابقت رکھنے والا API ہے۔ کلید میں خود دوں گا: اسے ریپوزٹری کی فائلوں میں محفوظ نہ کریں اور گلوبل ماحول کے متغیرات تبدیل نہ کریں۔ آخر میں ایک مختصر درخواست سے کنکشن کی تصدیق کریں اور نتیجہ بتائیں۔

    مرحلہ وار گائیڈ: Claude Code۔

  3. تصدیق

    اکاؤنٹ بیلنس — یہ درخواست کوئی ٹوکن خرچ نہیں کرتی:

    cURL
    curl -s https://gate.joingonka.ai/api/balance \
      -H "Authorization: Bearer $JOINGONKA_API_KEY"

    ماڈل کو مختصر درخواست — کوڈ 200 کے ساتھ جواب کا مطلب ہے سب کچھ ٹھیک ترتیب ہے:

    cURL
    curl -s https://gate.joingonka.ai/v1/chat/completions \
      -H "Authorization: Bearer $JOINGONKA_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model": "MiniMaxAI/MiniMax-M2.7", "messages": [{"role": "user", "content": "Say OK"}], "max_tokens": 32}'

تمام ٹولز#

ٹولقسمانسٹالر
CursorIDE--tool cursor
Claude CodeCLI ایجنٹ--tool claude-code
OpenClawCLI ایجنٹ--tool openclaw
OpenCodeCLI ایجنٹ--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderCLI ایجنٹ--tool aider
LangChainفریم ورک—
n8nفریم ورک—
Open WebUIچیٹ—
LibreChatچیٹ—
HermesCLI ایجنٹ--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndexفریم ورک—
PydanticAIفریم ورک—
Vercel AI SDKفریم ورک—
TanStack AIفریم ورک—
ZCodeCLI ایجنٹ--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiCLI ایجنٹ--tool pi
Codex CLICLI ایجنٹ--tool codex
DeepSeek HarnessCLI ایجنٹ—
MiniMax CodeCLI ایجنٹ--tool minimax-code
WarpCLI ایجنٹ—
TraeIDE—
Cherry Studioچیٹ—
omp (Oh My Pi)CLI ایجنٹ--tool omp
OpenHandsCLI ایجنٹ—
Qwen CodeCLI ایجنٹ--tool qwen-code
GooseCLI ایجنٹ--tool goose
CrushCLI ایجنٹ--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeCLI ایجنٹ--tool kimi-code
Factory DroidCLI ایجنٹ--tool droid
MiMo CodeCLI ایجنٹ--tool mimo-code

کوڈ کی مثالیں#

OpenAI SDK، cURL اور Anthropic SDK کے ذریعے ایک ہی درخواست۔ کلید JOINGONKA_API_KEY ماحول کے متغیر سے لی جاتی ہے۔

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key=os.environ["JOINGONKA_API_KEY"],
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "What is Gonka?"}],
)
print(response.choices[0].message.content)

دستاویزات کے حصے#

  • API — Gonka نیٹ ورک کے ماڈلز کے لیے OpenAI اور Anthropic کے مطابق API کا حوالہ: کیز، پیرامیٹرز، اسٹریمنگ، ٹولز، پلگ انز۔ سائن اپ پر مفت ٹوکنز۔
  • ماڈلز — Gonka نیٹ ورک کے ماڈلز ایک ہی API میں: model فیلڈ کے لیے id، کنٹیکسٹ، جواب کی حد، قیمتیں اور اسٹیٹس۔ وہی اوپن ماڈلز کئی گنا سستے میں۔
  • خرابیاں اور حدود — گیٹ وے کے ایرر کوڈز، ریکویسٹ کی حدود اور ٹائم آؤٹ: ہر جواب کا مطلب کیا ہے اور ریکویسٹ کب دہرانی ہے۔
  • قیمتیں اور اکاؤنٹ — Gonka نیٹ ورک کے ماڈلز فی ٹوکن قیمت پر: شروع میں مفت ٹوکنز، GNK، USDT یا کارڈ سے ٹاپ اپ، تمام فیس کھلے طور پر اور اخراجات ٹریک کرنے کے لیے اکاؤنٹ API۔
  • ایجنٹس کے لیے — AI ایجنٹ کو لنک دیں — وہ خود Claude Code، Cursor یا Codex کو Gonka نیٹ ورک کے ماڈلز سے جوڑ دے گا: تیار پرامپٹ، ہدایات اور اسکل۔