> 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/bn/knowledge/cursor/) | IDE | `--tool cursor` |
| [Claude Code](https://joingonka.ai/bn/knowledge/claude-code/) | CLI এজেন্ট | `--tool claude-code` |
| [OpenClaw](https://joingonka.ai/bn/knowledge/openclaw/) | CLI এজেন্ট | `--tool openclaw` |
| [OpenCode](https://joingonka.ai/bn/knowledge/opencode/) | CLI এজেন্ট | `--tool opencode` |
| [Continue](https://joingonka.ai/bn/knowledge/continue-dev/) | IDE | `--tool continue` |
| [Cline](https://joingonka.ai/bn/knowledge/cline/) | IDE | `--tool cline` |
| [Aider](https://joingonka.ai/bn/knowledge/aider/) | CLI এজেন্ট | `--tool aider` |
| [LangChain](https://joingonka.ai/bn/knowledge/langchain/) | ফ্রেমওয়ার্ক | — |
| [n8n](https://joingonka.ai/bn/knowledge/n8n/) | ফ্রেমওয়ার্ক | — |
| [Open WebUI](https://joingonka.ai/bn/knowledge/open-webui/) | চ্যাট | — |
| [LibreChat](https://joingonka.ai/bn/knowledge/librechat/) | চ্যাট | — |
| [Hermes](https://joingonka.ai/bn/knowledge/hermes/) | CLI এজেন্ট | `--tool hermes` |
| [Kilo Code](https://joingonka.ai/bn/knowledge/kilo-code/) | IDE | `--tool kilo` |
| [Roo Code](https://joingonka.ai/bn/knowledge/roo-code/) | IDE | `--tool roo` |
| [LlamaIndex](https://joingonka.ai/bn/knowledge/llamaindex/) | ফ্রেমওয়ার্ক | — |
| [PydanticAI](https://joingonka.ai/bn/knowledge/pydantic-ai/) | ফ্রেমওয়ার্ক | — |
| [Vercel AI SDK](https://joingonka.ai/bn/knowledge/vercel-ai-sdk/) | ফ্রেমওয়ার্ক | — |
| [TanStack AI](https://joingonka.ai/bn/knowledge/tanstack-ai/) | ফ্রেমওয়ার্ক | — |
| [ZCode](https://joingonka.ai/bn/knowledge/zcode/) | CLI এজেন্ট | `--tool zcode` |
| [JetBrains](https://joingonka.ai/bn/knowledge/jetbrains/) | IDE | `--tool jetbrains` |
| [Copilot BYOK](https://joingonka.ai/bn/knowledge/copilot-byok/) | IDE | `--tool copilot-byok` |
| [Zed](https://joingonka.ai/bn/knowledge/zed/) | IDE | `--tool zed` |
| [Pi](https://joingonka.ai/bn/knowledge/pi/) | CLI এজেন্ট | `--tool pi` |
| [Codex CLI](https://joingonka.ai/bn/knowledge/codex/) | CLI এজেন্ট | `--tool codex` |
| [DeepSeek Harness](https://joingonka.ai/bn/knowledge/deepseek-harness/) | CLI এজেন্ট | — |
| [MiniMax Code](https://joingonka.ai/bn/knowledge/minimax-code/) | CLI এজেন্ট | `--tool minimax-code` |
| [Warp](https://joingonka.ai/bn/knowledge/warp/) | CLI এজেন্ট | — |
| [Trae](https://joingonka.ai/bn/knowledge/trae/) | IDE | — |
| [Cherry Studio](https://joingonka.ai/bn/knowledge/cherry-studio/) | চ্যাট | — |
| [omp (Oh My Pi)](https://joingonka.ai/bn/knowledge/omp/) | CLI এজেন্ট | `--tool omp` |
| [OpenHands](https://joingonka.ai/bn/knowledge/openhands/) | CLI এজেন্ট | — |
| [Qwen Code](https://joingonka.ai/bn/knowledge/qwen-code/) | CLI এজেন্ট | `--tool qwen-code` |
| [Goose](https://joingonka.ai/bn/knowledge/goose/) | CLI এজেন্ট | `--tool goose` |
| [Crush](https://joingonka.ai/bn/knowledge/crush/) | CLI এজেন্ট | `--tool crush` |
| [Zoo Code](https://joingonka.ai/bn/knowledge/zoo-code/) | IDE | `--tool zoo` |
| [Kimi Code](https://joingonka.ai/bn/knowledge/kimi-code/) | CLI এজেন্ট | `--tool kimi-code` |
| [Factory Droid](https://joingonka.ai/bn/knowledge/factory-droid/) | CLI এজেন্ট | `--tool droid` |
| [MiMo Code](https://joingonka.ai/bn/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/bn/docs/api) — Gonka নেটওয়ার্কের মডেলের জন্য OpenAI ও Anthropic-সামঞ্জস্যপূর্ণ API-এর রেফারেন্স: কী, প্যারামিটার, স্ট্রিমিং, টুল, প্লাগইন। সাইনআপে ফ্রি টোকেন।
- [মডেল](https://gate.joingonka.ai/bn/docs/models) — Gonka নেটওয়ার্কের মডেল একটি API-তে: model ফিল্ডের জন্য id, কনটেক্সট, রেসপন্স লিমিট, দাম ও স্ট্যাটাস। একই ওপেন মডেল কয়েকগুণ কম দামে।
- [ত্রুটি ও সীমা](https://gate.joingonka.ai/bn/docs/errors) — গেটওয়ের এরর কোড, রিকোয়েস্ট লিমিট ও টাইমআউট: প্রতিটি রেসপন্সের অর্থ কী এবং কখন রিকোয়েস্ট আবার পাঠাতে হবে।
- [মূল্য ও অ্যাকাউন্ট](https://gate.joingonka.ai/bn/docs/billing) — Gonka নেটওয়ার্কের মডেল প্রতি টোকেন দামে: শুরুতে ফ্রি টোকেন, GNK, USDT বা কার্ড দিয়ে টপ-আপ, সব ফি প্রকাশ্যে এবং খরচ ট্র্যাক করার জন্য অ্যাকাউন্ট API।
- [এজেন্টদের জন্য](https://gate.joingonka.ai/bn/docs/agents) — AI এজেন্টকে লিঙ্ক দিন — সে নিজেই Claude Code, Cursor বা Codex Gonka নেটওয়ার্কের মডেলের সাথে যুক্ত করবে: রেডিমেড প্রম্পট, নির্দেশিকা ও স্কিল।