JoinGonka Gateway - مراجعة كاملة

JoinGonka Gateway هو طبقة وسيطة بين تطبيقك وشبكة Gonka. البنية التحتية:

1. تطبيقك يرسل طلبًا إلى gate.joingonka.ai/v1/chat/completions (بتنسيق OpenAI) أو gate.joingonka.ai/v1/messages (بتنسيق Anthropic).
2. Gateway يستقبل الطلب بأي من التنسيقين، ويتحقق من مفتاح API والرصيد، ثم يعيد توجيهه إلى شبكة Gonka.
3. شبكة Gonka تعالج الطلب على واحدة من حوالي ~582 عقدة ML (ML-node) بنموذج Kimi K2.6.
4. Gateway يتلقى الاستجابة، ويحسب الرموز المستهلكة، ويخصم من الرصيد، ويعيد الرد إلى تطبيقك — بنفس التنسيق الذي تم استلام الطلب به (OpenAI أو Anthropic).

تنسيقان لـ API: يدعم Gateway كلاً من OpenAI Chat Completions API (/v1/chat/completions) و Anthropic Messages API (/v1/messages). هذا يعني أن أدوات مثل Cursor و LangChain تعمل عبر تنسيق OpenAI، بينما يتصل Claude Code مباشرة عبر تنسيق Anthropic — دون وكلاء أو محولات.

لماذا تحتاج إلى Gateway إذا كان هناك API مباشر لـ Gonka؟ يتطلب API المباشر لـ Gonka محفظة عملات رقمية، وتوقيع معاملات GNK، وفهمًا للبلوكشين. JoinGonka Gateway يزيل هذا التعقيد: أنت تدفع بالعملة المريحة لك (GNK، USDT، العملات التقليدية/fiat)، وتحصل على تنسيق API مألوف (OpenAI أو Anthropic)، وتستخدم لوحة التحكم (Dashboard) للمراقبة — دون الحاجة لأي معرفة بالعملات الرقمية.

الحزمة التقنية: Fastify (Node.js)، PostgreSQL، nginx. يعالج Gateway ما يصل إلى 1000 طلب في الثانية، ويدعم البث (streaming/SSE بكلا التنسيقين)، و tool calling، وجميع بارامترات OpenAI Chat Completions + Anthropic Messages API. زمن التأخير المضاف هو أقل من 50 مللي ثانية.

العملية بأكملها تستغرق دقيقتين:

1. التسجيل: انتقل إلى gate.joingonka.ai/register. البريد الإلكتروني + كلمة المرور — نموذج قياسي.
2. المكافأة: عند التسجيل، يتم منحك تلقائيًا 10,000,000 رمز مجاني. هذا يكفي لآلاف طلبات الذكاء الاصطناعي — يكفي للاختبار والتكاملات الأولى.
3. إنشاء مفتاح: في Dashboard ← API Keys ← Create Key. يبدأ المفتاح بـ jg-، على سبيل المثال jg-abc123def456. يظهر مرة واحدة فقط — احفظه.
4. الطلب الأول: استخدم المفتاح في أي عميل متوافق مع OpenAI أو Anthropic. لتنسيق OpenAI، استبدل base_url بـ https://gate.joingonka.ai/v1. لتنسيق Anthropic (Claude Code) — ANTHROPIC_BASE_URL=https://gate.joingonka.ai.

تعليمات جاهزة للأدوات الشائعة: Cursor، Claude Code، Aider، Continue.dev، Cline، LangChain، n8n، Open WebUI، LibreChat. أمثلة التعليمات البرمجية (curl، Python، TypeScript) — في بدء سريع API.

لوحة التحكم: في حسابك الشخصي، يمكنك رؤية: الرصيد الحالي للرموز، وسجل الطلبات، والإنفاق اليومي، ومفاتيح API، ورابط الإحالة. هذه لوحة تحكم كاملة لإدارة نفقات الذكاء الاصطناعي.

نفس النماذج المفتوحة التي توزعها شبكة Gonka اللامركزية متاحة أيضًا على منصات الاستنتاج (inference) العادية - على سبيل المثال OpenRouter. الفرق يكمن في التكلفة. لنقارن السعر لكل مليون توكن لنفس النماذج:

نفس النموذج - أرخص بمئات المرات. توفر JoinGonka Gateway نماذج MiniMax-M2.7 و Kimi-K2.6 بسعر ~0.003 دولار للمدخلات و ~0.009 دولار للمخرجات لكل مليون توكن (المخرجات أغلى بثلاث مرات - كما هو الحال مع مزودي الخدمة الآخرين). في المنصات العادية، تكلف أوزان نفس النموذج مئات المرات أكثر: السبب يكمن في البنية التحتية - في Gonka، يتم دفع تكاليف الاستنتاج للمعدنين (miners) من خلال Proof of Useful Work، وليس من خلال هامش ربح مراكز البيانات.

ليس فقط السعر. توفر JoinGonka Gateway كلا تنسيقي API - OpenAI (/v1/chat/completions) و Anthropic (/v1/messages)، بحيث يمكن توصيل Claude Code مباشرة عبر تنسيق Anthropic الأصلي. بالإضافة إلى ميزة الاستدعاء الأصلي للأدوات (tool calling)، ولوحة تحكم مع تحليلات، ودفع مرن (GNK 0%, USDT 5%, العملات الورقية)، وبرنامج إحالة (10% L1 + 3% L2).

ثماني مزايا رئيسية:

1. أرخص API متوافق مع OpenAI + Anthropic: سعر 0.003 دولار لكل مليون توكن - أرخص بـ 930 مرة من OpenAI GPT-5.5. بالنسبة لمعظم المهام، الفرق غير ملحوظ من حيث الجودة، ولكنه جذري من حيث التكلفة.
2. تنسيقان للـ API - OpenAI و Anthropic: /v1/chat/completions (OpenAI) و /v1/messages (Anthropic) - كلاهما يعمل بمفتاح واحد. يمكن لـ Cursor و LangChain و openai SDK العمل عبر تنسيق OpenAI. أما Claude Code فيعمل عبر تنسيق Anthropic مباشرة وبدون وكيل (proxy). لا يوجد منافس يقدم هذا.
3. الاستدعاء الأصلي للأدوات (Native tool calling): يدعم Kimi K2.6 استدعاء الوظائف (function calling) في كلا التنسيقين - OpenAI و Anthropic. الوكلاء (Agents) والسلاسل والأتمتة - كل شيء يعمل بشكل موثوق.
4. بداية مجانية: 10 مليون توكن عند التسجيل. يكفي لأسابيع من الاختبار وعمليات الدمج الأولى - بدون دفع.
5. دفع مرن: GNK (عمولة 0%)، USDT (5%)، العملات الورقية عبر On-Ramp. لا حاجة لفهم العملات المشفرة - يمكنك الدفع بالبطاقة.
6. برنامج الإحالة: 10% من إنفاق المستخدمين المدعوين (L1) + 3% من المحالين من قبلهم (L2). شارك الرابط واكسب التوكنات.
7. لوحة تحكم وتحليلات: نظام إدارة علاقات عملاء (CRM) كامل - الرصيد، الإنفاق، سجل الطلبات، مفاتيح API. كل شيء في واجهة واحدة.
8. توافق كامل مع النظام البيئي: يعمل مع أي عميل متوافق مع OpenAI (Cursor, n8n, LangChain) وعميل متوافق مع Anthropic (Claude Code) - بدون أي تعديلات.

يعمل فواتير JoinGonka Gateway بتوكنات GNK (وحدة داخلية):

• شحن GNK: عمولة 0%. ترسل GNK إلى عنوان Gateway، ويتم إضافة الرصيد فوراً.
• شحن USDT: عمولة 5%. تدفع بـ USDT (عبر OxaPay)، وسيقوم Gateway بتحويلها إلى GNK تلقائياً. نسبة 5% هي رسوم مقابل الراحة (لا حاجة لمحفظة Gonka مشفرة).
• شحن العملات الورقية: عبر On-Ramp (بطاقة ← USDT ← GNK). تعتمد الرسوم على مزود خدمة On-Ramp.

عمولة المنصة: يتم تطبيق عمولة 10% على تكلفة الاستنتاج الأساسية في شبكة Gonka. هذه العمولة مشمولة بالفعل في السعر النهائي البالغ ~0.003 دولار لكل مليون توكن. التكلفة الأساسية في الشبكة هي ~0.0027 دولار لكل مليون، ومع العمولة تصبح ~0.003 دولار لكل مليون. تغطي العمولة تكاليف البنية التحتية لـ Gateway (خوادم، قواعد بيانات، مراقبة).

كيف يتم حساب الإنفاق: يستهلك كل طلب إلى API (سواء عبر تنسيق OpenAI أو تنسيق Anthropic) توكنات من الرصيد الموحد. يقوم Gateway بحساب prompt_tokens (المدخلات) + completion_tokens (المخرجات) ويخصمها من الرصيد. التكلفة: 0.003 دولار لكل مليون توكن (~0.003 GNK بسعر الصرف الحالي). مفتاح واحد، رصيد واحد - لكلا تنسيقي الـ API.

استدعاء الأدوات (Tool calling): تستهلك استدعاءات الوظائف (tools) توكنات أيضاً - حيث تضاف تعريفات الوظائف إلى الـ prompt. يستهلك طلب استدعاء الأدوات النموذجي توكنات أكثر بـ 1.5-3 مرات من الطلب العادي - ولكن بسعر 0.003 دولار لكل مليون توكن، لا تزال التكلفة زهيدة جداً.

برنامج الإحالة: يحصل كل مستخدم على رابط إحالة فريد في لوحة التحكم. عندما يستهلك المستخدم المدعو توكنات - تحصل أنت على 10% من إنفاقه (L1). إذا قام المحال من قبلك بدعوة أشخاص آخرين - تحصل أنت على 3% من إنفاقهم (L2). يتم إضافة مكافآت الإحالة بتوكنات GNK إلى رصيدك.

الشفافية: يمكن رؤية جميع المعاملات في لوحة التحكم - عمليات الشحن، الخصم، مكافآت الإحالة. يعيد الـ API كائن usage مع كل رد - فأنت دائماً تعرف عدد التوكنات التي استهلكها الطلب.

معلمات النموذج: تدعم نماذج الشبكة نافذة سياق (context window) تبلغ 200 ألف توكن. الحد الأقصى لطول الرد - يصل إلى 8192 توكن (لجميع نماذج الشبكة؛ الافتراضي بدون max_tokens هو 1500). معلمات API المدعومة: model, messages, max_tokens, temperature, tools, tool_choice, stream.