لعملاء الذكاء الاصطناعي: تعليمات الإعداد خطوة بخطوة — /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

  1. المفتاح

    سجّل في gate.joingonka.ai وأنشئ مفتاحًا من لوحة حسابك. فور التسجيل يُضاف إلى رصيدك 3M من الرموز المجانية.

    احصل على مفتاح API
  2. الربط

    سيتولى المثبّت إعداد Claude Code بنفسه: يطلب المفتاح بإدخال مخفي، ثم يكتب ملف الإعداد ويتحقق من الاتصال بطلب إلى البوابة.

    Bash
    npx -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.

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

كل الأدوات#

الأداةالنوعالمثبّت
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)

أقسام التوثيق#

  • API — مرجع API المتوافق مع OpenAI وAnthropic لنماذج شبكة Gonka: المفاتيح والمعاملات والبث والأدوات والإضافات. رموز مجانية عند التسجيل.
  • النماذج — نماذج شبكة Gonka في API واحد: المعرّف لحقل model، والسياق، وحد الرد، والأسعار والحالة. النماذج المفتوحة نفسها بأسعار أقل بعشرات المرات.
  • الأخطاء والحدود — رموز أخطاء البوابة وحدود الطلبات والمهلات الزمنية: معنى كل استجابة ومتى تعيد المحاولة.
  • الأسعار والحساب — نماذج شبكة Gonka بسعر لكل رمز: رموز مجانية عند البداية، وشحن بـGNK أو USDT أو البطاقة، وجميع الرسوم معلنة، وAPI حساب لتتبع النفقات.
  • للعملاء الأذكياء — أرسل الرابط إلى عميل الذكاء الاصطناعي وسيتولى بنفسه ربط Claude Code أو Cursor أو Codex بنماذج شبكة Gonka: أمر جاهز وتعليمات ومهارة.