> لعملاء الذكاء الاصطناعي: تعليمات الإعداد خطوة بخطوة — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md)، فهرس الوثائق — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# اربط نماذج Gonka بأداتك

واجهة API متوافقة مع OpenAI وAnthropic. اختر أداتك واحصل على أمر التثبيت، والموجّه (prompt) للوكيل، وخطوة التحقق.

## حقائق سريعة

- العنوان الأساسي لعملاء OpenAI API: `https://gate.joingonka.ai/v1`
- العنوان الأساسي لعملاء Anthropic API، بدون `/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
```

أو أوكل الإعداد إلى وكيل ذكاء اصطناعي — أرسل إليه هذا الموجّه:

```text
اربط أداتك بـ JoinGonka Gateway — واجهة API المتوافقة مع OpenAI وAnthropic لشبكة Gonka — حسب التعليمات في https://gate.joingonka.ai/docs/agents.md. سأزوّدك بالمفتاح بنفسي: لا تحفظه في ملفات المستودع ولا تغيّر متغيرات البيئة العامة. في النهاية، تحقق من الاتصال بطلب قصير وأبلغني بالنتيجة.
```

أدلة خطوة بخطوة لكل أداة — عبر الروابط في الجدول أدناه.

### التحقق

رصيد الحساب — هذا الطلب لا يستهلك رموزًا:

```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/ar/knowledge/cursor/) | بيئة تطوير IDE | `--tool cursor` |
| [Claude Code](https://joingonka.ai/ar/knowledge/claude-code/) | وكيل CLI | `--tool claude-code` |
| [OpenClaw](https://joingonka.ai/ar/knowledge/openclaw/) | وكيل CLI | `--tool openclaw` |
| [OpenCode](https://joingonka.ai/ar/knowledge/opencode/) | وكيل CLI | `--tool opencode` |
| [Continue](https://joingonka.ai/ar/knowledge/continue-dev/) | بيئة تطوير IDE | `--tool continue` |
| [Cline](https://joingonka.ai/ar/knowledge/cline/) | بيئة تطوير IDE | `--tool cline` |
| [Aider](https://joingonka.ai/ar/knowledge/aider/) | وكيل CLI | `--tool aider` |
| [LangChain](https://joingonka.ai/ar/knowledge/langchain/) | إطار عمل | — |
| [n8n](https://joingonka.ai/ar/knowledge/n8n/) | إطار عمل | — |
| [Open WebUI](https://joingonka.ai/ar/knowledge/open-webui/) | دردشة | — |
| [LibreChat](https://joingonka.ai/ar/knowledge/librechat/) | دردشة | — |
| [Hermes](https://joingonka.ai/ar/knowledge/hermes/) | وكيل CLI | `--tool hermes` |
| [Kilo Code](https://joingonka.ai/ar/knowledge/kilo-code/) | بيئة تطوير IDE | `--tool kilo` |
| [Roo Code](https://joingonka.ai/ar/knowledge/roo-code/) | بيئة تطوير IDE | `--tool roo` |
| [LlamaIndex](https://joingonka.ai/ar/knowledge/llamaindex/) | إطار عمل | — |
| [PydanticAI](https://joingonka.ai/ar/knowledge/pydantic-ai/) | إطار عمل | — |
| [Vercel AI SDK](https://joingonka.ai/ar/knowledge/vercel-ai-sdk/) | إطار عمل | — |
| [TanStack AI](https://joingonka.ai/ar/knowledge/tanstack-ai/) | إطار عمل | — |
| [ZCode](https://joingonka.ai/ar/knowledge/zcode/) | وكيل CLI | `--tool zcode` |
| [JetBrains](https://joingonka.ai/ar/knowledge/jetbrains/) | بيئة تطوير IDE | `--tool jetbrains` |
| [Copilot BYOK](https://joingonka.ai/ar/knowledge/copilot-byok/) | بيئة تطوير IDE | `--tool copilot-byok` |
| [Zed](https://joingonka.ai/ar/knowledge/zed/) | بيئة تطوير IDE | `--tool zed` |
| [Pi](https://joingonka.ai/ar/knowledge/pi/) | وكيل CLI | `--tool pi` |
| [Codex CLI](https://joingonka.ai/ar/knowledge/codex/) | وكيل CLI | `--tool codex` |
| [DeepSeek Harness](https://joingonka.ai/ar/knowledge/deepseek-harness/) | وكيل CLI | — |
| [MiniMax Code](https://joingonka.ai/ar/knowledge/minimax-code/) | وكيل CLI | `--tool minimax-code` |
| [Warp](https://joingonka.ai/ar/knowledge/warp/) | وكيل CLI | — |
| [Trae](https://joingonka.ai/ar/knowledge/trae/) | بيئة تطوير IDE | — |
| [Cherry Studio](https://joingonka.ai/ar/knowledge/cherry-studio/) | دردشة | — |
| [omp (Oh My Pi)](https://joingonka.ai/ar/knowledge/omp/) | وكيل CLI | `--tool omp` |
| [OpenHands](https://joingonka.ai/ar/knowledge/openhands/) | وكيل CLI | — |
| [Qwen Code](https://joingonka.ai/ar/knowledge/qwen-code/) | وكيل CLI | `--tool qwen-code` |
| [Goose](https://joingonka.ai/ar/knowledge/goose/) | وكيل CLI | `--tool goose` |
| [Crush](https://joingonka.ai/ar/knowledge/crush/) | وكيل CLI | `--tool crush` |
| [Zoo Code](https://joingonka.ai/ar/knowledge/zoo-code/) | بيئة تطوير IDE | `--tool zoo` |
| [Kimi Code](https://joingonka.ai/ar/knowledge/kimi-code/) | وكيل CLI | `--tool kimi-code` |
| [Factory Droid](https://joingonka.ai/ar/knowledge/factory-droid/) | وكيل CLI | `--tool droid` |
| [MiMo Code](https://joingonka.ai/ar/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/ar/docs/api) — مرجع API المتوافق مع OpenAI وAnthropic لنماذج شبكة Gonka: المفاتيح والمعاملات والبث والأدوات والإضافات. رموز مجانية عند التسجيل.
- [النماذج](https://gate.joingonka.ai/ar/docs/models) — نماذج شبكة Gonka في API واحد: المعرّف لحقل model، والسياق، وحد الرد، والأسعار والحالة. النماذج المفتوحة نفسها بأسعار أقل بعشرات المرات.
- [الأخطاء والحدود](https://gate.joingonka.ai/ar/docs/errors) — رموز أخطاء البوابة وحدود الطلبات والمهلات الزمنية: معنى كل استجابة ومتى تعيد المحاولة.
- [الأسعار والحساب](https://gate.joingonka.ai/ar/docs/billing) — نماذج شبكة Gonka بسعر لكل رمز: رموز مجانية عند البداية، وشحن بـGNK أو USDT أو البطاقة، وجميع الرسوم معلنة، وAPI حساب لتتبع النفقات.
- [للعملاء الأذكياء](https://gate.joingonka.ai/ar/docs/agents) — أرسل الرابط إلى عميل الذكاء الاصطناعي وسيتولى بنفسه ربط Claude Code أو Cursor أو Codex بنماذج شبكة Gonka: أمر جاهز وتعليمات ومهارة.