> AI ایجنٹس کے لیے: سیٹ اپ کی مرحلہ وار ہدایات — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md)، دستاویزات کا انڈیکس — [`/llms.txt`](https://gate.joingonka.ai/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) ایک کمانڈ میں ترتیب دیتا ہے، باقی گائیڈ کے مطابق جڑتے ہیں۔

### کلید

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

### جوڑنا

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

```bash
npx -y @joingonka/setup --tool <id> --model MiniMaxAI/MiniMax-M2.7
```

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

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

ہر ٹول کے لیے مرحلہ وار گائیڈز — نیچے جدول کے لنکس پر۔

### تصدیق

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

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

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

```bash
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}'
```

### تمام ٹولز

| ٹول | قسم | انسٹالر |
| --- | --- | --- |
| [Cursor](https://joingonka.ai/ur/knowledge/cursor/) | IDE | `--tool cursor` |
| [Claude Code](https://joingonka.ai/ur/knowledge/claude-code/) | CLI ایجنٹ | `--tool claude-code` |
| [OpenClaw](https://joingonka.ai/ur/knowledge/openclaw/) | CLI ایجنٹ | `--tool openclaw` |
| [OpenCode](https://joingonka.ai/ur/knowledge/opencode/) | CLI ایجنٹ | `--tool opencode` |
| [Continue](https://joingonka.ai/ur/knowledge/continue-dev/) | IDE | `--tool continue` |
| [Cline](https://joingonka.ai/ur/knowledge/cline/) | IDE | `--tool cline` |
| [Aider](https://joingonka.ai/ur/knowledge/aider/) | CLI ایجنٹ | `--tool aider` |
| [LangChain](https://joingonka.ai/ur/knowledge/langchain/) | فریم ورک | — |
| [n8n](https://joingonka.ai/ur/knowledge/n8n/) | فریم ورک | — |
| [Open WebUI](https://joingonka.ai/ur/knowledge/open-webui/) | چیٹ | — |
| [LibreChat](https://joingonka.ai/ur/knowledge/librechat/) | چیٹ | — |
| [Hermes](https://joingonka.ai/ur/knowledge/hermes/) | CLI ایجنٹ | `--tool hermes` |
| [Kilo Code](https://joingonka.ai/ur/knowledge/kilo-code/) | IDE | `--tool kilo` |
| [Roo Code](https://joingonka.ai/ur/knowledge/roo-code/) | IDE | `--tool roo` |
| [LlamaIndex](https://joingonka.ai/ur/knowledge/llamaindex/) | فریم ورک | — |
| [PydanticAI](https://joingonka.ai/ur/knowledge/pydantic-ai/) | فریم ورک | — |
| [Vercel AI SDK](https://joingonka.ai/ur/knowledge/vercel-ai-sdk/) | فریم ورک | — |
| [TanStack AI](https://joingonka.ai/ur/knowledge/tanstack-ai/) | فریم ورک | — |
| [ZCode](https://joingonka.ai/ur/knowledge/zcode/) | CLI ایجنٹ | `--tool zcode` |
| [JetBrains](https://joingonka.ai/ur/knowledge/jetbrains/) | IDE | `--tool jetbrains` |
| [Copilot BYOK](https://joingonka.ai/ur/knowledge/copilot-byok/) | IDE | `--tool copilot-byok` |
| [Zed](https://joingonka.ai/ur/knowledge/zed/) | IDE | `--tool zed` |
| [Pi](https://joingonka.ai/ur/knowledge/pi/) | CLI ایجنٹ | `--tool pi` |
| [Codex CLI](https://joingonka.ai/ur/knowledge/codex/) | CLI ایجنٹ | `--tool codex` |
| [DeepSeek Harness](https://joingonka.ai/ur/knowledge/deepseek-harness/) | CLI ایجنٹ | — |
| [MiniMax Code](https://joingonka.ai/ur/knowledge/minimax-code/) | CLI ایجنٹ | `--tool minimax-code` |
| [Warp](https://joingonka.ai/ur/knowledge/warp/) | CLI ایجنٹ | — |
| [Trae](https://joingonka.ai/ur/knowledge/trae/) | IDE | — |
| [Cherry Studio](https://joingonka.ai/ur/knowledge/cherry-studio/) | چیٹ | — |
| [omp (Oh My Pi)](https://joingonka.ai/ur/knowledge/omp/) | CLI ایجنٹ | `--tool omp` |
| [OpenHands](https://joingonka.ai/ur/knowledge/openhands/) | CLI ایجنٹ | — |
| [Qwen Code](https://joingonka.ai/ur/knowledge/qwen-code/) | CLI ایجنٹ | `--tool qwen-code` |
| [Goose](https://joingonka.ai/ur/knowledge/goose/) | CLI ایجنٹ | `--tool goose` |
| [Crush](https://joingonka.ai/ur/knowledge/crush/) | CLI ایجنٹ | `--tool crush` |
| [Zoo Code](https://joingonka.ai/ur/knowledge/zoo-code/) | IDE | `--tool zoo` |
| [Kimi Code](https://joingonka.ai/ur/knowledge/kimi-code/) | CLI ایجنٹ | `--tool kimi-code` |
| [Factory Droid](https://joingonka.ai/ur/knowledge/factory-droid/) | CLI ایجنٹ | `--tool droid` |
| [MiMo Code](https://joingonka.ai/ur/knowledge/mimo-code/) | CLI ایجنٹ | `--tool mimo-code` |

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

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

### Python

```python
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)
```

### TypeScript

```typescript
import OpenAI from "openai";

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

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

### cURL

```bash
curl 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": "What is Gonka?"}]
  }'
```

### Anthropic SDK

```python
import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://gate.joingonka.ai",
    api_key=os.environ["JOINGONKA_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)
```

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

- [API](https://gate.joingonka.ai/ur/docs/api) — Gonka نیٹ ورک کے ماڈلز کے لیے OpenAI اور Anthropic کے مطابق API کا حوالہ: کیز، پیرامیٹرز، اسٹریمنگ، ٹولز، پلگ انز۔ سائن اپ پر مفت ٹوکنز۔
- [ماڈلز](https://gate.joingonka.ai/ur/docs/models) — Gonka نیٹ ورک کے ماڈلز ایک ہی API میں: model فیلڈ کے لیے id، کنٹیکسٹ، جواب کی حد، قیمتیں اور اسٹیٹس۔ وہی اوپن ماڈلز کئی گنا سستے میں۔
- [خرابیاں اور حدود](https://gate.joingonka.ai/ur/docs/errors) — گیٹ وے کے ایرر کوڈز، ریکویسٹ کی حدود اور ٹائم آؤٹ: ہر جواب کا مطلب کیا ہے اور ریکویسٹ کب دہرانی ہے۔
- [قیمتیں اور اکاؤنٹ](https://gate.joingonka.ai/ur/docs/billing) — Gonka نیٹ ورک کے ماڈلز فی ٹوکن قیمت پر: شروع میں مفت ٹوکنز، GNK، USDT یا کارڈ سے ٹاپ اپ، تمام فیس کھلے طور پر اور اخراجات ٹریک کرنے کے لیے اکاؤنٹ API۔
- [ایجنٹس کے لیے](https://gate.joingonka.ai/ur/docs/agents) — AI ایجنٹ کو لنک دیں — وہ خود Claude Code، Cursor یا Codex کو Gonka نیٹ ورک کے ماڈلز سے جوڑ دے گا: تیار پرامپٹ، ہدایات اور اسکل۔