لعملاء الذكاء الاصطناعي: تعليمات الإعداد خطوة بخطوة — /docs/agents.md، فهرس الوثائق — /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 أداة) بأمر واحد، أما البقية فتُربط عبر الدليل.
Claude Code
المفتاح
سجّل في gate.joingonka.ai وأنشئ مفتاحًا من لوحة حسابك. فور التسجيل يُضاف إلى رصيدك 3M من الرموز المجانية.
احصل على مفتاح APIالربط
سيتولى المثبّت إعداد Claude Code بنفسه: يطلب المفتاح بإدخال مخفي، ثم يكتب ملف الإعداد ويتحقق من الاتصال بطلب إلى البوابة.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7أو أوكل الإعداد إلى وكيل ذكاء اصطناعي — أرسل إليه هذا الموجّه:
الموجّه للوكيلاربط Claude Code بـ JoinGonka Gateway — واجهة API المتوافقة مع OpenAI وAnthropic لشبكة Gonka — حسب التعليمات في https://gate.joingonka.ai/docs/agents.md. سأزوّدك بالمفتاح بنفسي: لا تحفظه في ملفات المستودع ولا تغيّر متغيرات البيئة العامة. في النهاية، تحقق من الاتصال بطلب قصير وأبلغني بالنتيجة.دليل خطوة بخطوة: Claude Code.
التحقق
رصيد الحساب — هذا الطلب لا يستهلك رموزًا:
cURLcurl -s https://gate.joingonka.ai/api/balance \ -H "Authorization: Bearer $JOINGONKA_API_KEY"طلب قصير إلى النموذج — الرد برمز 200 يعني أن كل شيء مُعدّ بشكل صحيح:
cURLcurl -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 | بيئة تطوير IDE | --tool cursor |
| Claude Code | وكيل CLI | --tool claude-code |
| OpenClaw | وكيل CLI | --tool openclaw |
| OpenCode | وكيل CLI | --tool opencode |
| Continue | بيئة تطوير IDE | --tool continue |
| Cline | بيئة تطوير IDE | --tool cline |
| Aider | وكيل CLI | --tool aider |
| LangChain | إطار عمل | — |
| n8n | إطار عمل | — |
| Open WebUI | دردشة | — |
| LibreChat | دردشة | — |
| Hermes | وكيل CLI | --tool hermes |
| Kilo Code | بيئة تطوير IDE | --tool kilo |
| Roo Code | بيئة تطوير IDE | --tool roo |
| LlamaIndex | إطار عمل | — |
| PydanticAI | إطار عمل | — |
| Vercel AI SDK | إطار عمل | — |
| TanStack AI | إطار عمل | — |
| ZCode | وكيل CLI | --tool zcode |
| JetBrains | بيئة تطوير IDE | --tool jetbrains |
| Copilot BYOK | بيئة تطوير IDE | --tool copilot-byok |
| Zed | بيئة تطوير IDE | --tool zed |
| Pi | وكيل CLI | --tool pi |
| Codex CLI | وكيل CLI | --tool codex |
| DeepSeek Harness | وكيل CLI | — |
| MiniMax Code | وكيل CLI | --tool minimax-code |
| Warp | وكيل CLI | — |
| Trae | بيئة تطوير IDE | — |
| Cherry Studio | دردشة | — |
| omp (Oh My Pi) | وكيل CLI | --tool omp |
| OpenHands | وكيل CLI | — |
| Qwen Code | وكيل CLI | --tool qwen-code |
| Goose | وكيل CLI | --tool goose |
| Crush | وكيل CLI | --tool crush |
| Zoo Code | بيئة تطوير IDE | --tool zoo |
| Kimi Code | وكيل CLI | --tool kimi-code |
| Factory Droid | وكيل CLI | --tool droid |
| MiMo Code | وكيل CLI | --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)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 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?"}]
}'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 — مرجع API المتوافق مع OpenAI وAnthropic لنماذج شبكة Gonka: المفاتيح والمعاملات والبث والأدوات والإضافات. رموز مجانية عند التسجيل.
- النماذج — نماذج شبكة Gonka في API واحد: المعرّف لحقل model، والسياق، وحد الرد، والأسعار والحالة. النماذج المفتوحة نفسها بأسعار أقل بعشرات المرات.
- الأخطاء والحدود — رموز أخطاء البوابة وحدود الطلبات والمهلات الزمنية: معنى كل استجابة ومتى تعيد المحاولة.
- الأسعار والحساب — نماذج شبكة Gonka بسعر لكل رمز: رموز مجانية عند البداية، وشحن بـGNK أو USDT أو البطاقة، وجميع الرسوم معلنة، وAPI حساب لتتبع النفقات.
- للعملاء الأذكياء — أرسل الرابط إلى عميل الذكاء الاصطناعي وسيتولى بنفسه ربط Claude Code أو Cursor أو Codex بنماذج شبكة Gonka: أمر جاهز وتعليمات ومهارة.