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

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

1. تطبيقك يرسل طلباً إلى gate.joingonka.ai/v1/chat/completions (بتنسيق OpenAI) أو gate.joingonka.ai/v1/messages (بتنسيق Anthropic).
2. البوابة (Gateway) تستقبل الطلب بأي من التنسيقين، وتتحقق من مفتاح الـ API والرصيد، ثم تعيد توجيهه إلى شبكة Gonka.
3. شبكة Gonka تعالج الطلب على إحدى عُقد الـ ML التي تم نشر النموذج المختار عليها — سواء كان MiniMax M2.7 أو DeepSeek V4 Flash أو GLM-5.3 Flash.
4. البوابة تتلقى الرد، وتحسب الرموز المستهلكة، وتخصم من الرصيد، وتعيد الرد إلى تطبيقك — بنفس التنسيق الذي تم استلام الطلب به (OpenAI أو Anthropic).

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

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

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

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

1. التسجيل: انتقل إلى gate.joingonka.ai/register. البريد الإلكتروني + كلمة المرور — نموذج قياسي.
2. المكافأة: عند التسجيل يُضاف تلقائيًا 3M من الرموز المجانية. هذا يكفي لآلاف الطلبات إلى الذكاء الاصطناعي — كافٍ للاختبار والتكاملات الأولى.
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.

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

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

نفس النموذج — أرخص بحوالي 6 إلى 58 مرة. يقدم JoinGonka Gateway نماذج MiniMax-M2.7 و DeepSeek-V4-Flash (سياق 380 ألف — ثاني أطول سياق في الشبكة بعد 390 ألف لـ GLM-5.3-Flash) و GLM-5.3-Flash مقابل حوالي $0.0069 للمدخلات وحوالي $0.021 للمخرجات لكل مليون رمز (المخرجات أغلى بثلاث مرات — تماماً كما هو الحال لدى الموفرين الآخرين). في المنصات العادية، تكلف نفس أوزان النموذج حوالي 6 إلى 58 مرة أكثر: السبب يكمن في البنية التحتية — في Gonka، يتم دفع تكاليف الاستنتاج من قبل المعدنين عبر Proof of Useful Work، وليس من خلال هامش ربح مراكز البيانات.

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

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

1. أرخص API متوافق مع OpenAI + Anthropic: $0.0069 لكل مليون رمز — أرخص بحوالي 720 مرة من OpenAI GPT-5.5. بالنسبة لمعظم المهام، الفرق غير ملحوظ من حيث الجودة، لكنه جذري من حيث التكلفة.
2. تنسيقا API — OpenAI و Anthropic: /v1/chat/completions (OpenAI) و /v1/messages (Anthropic) — كلاهما يعمل بمفتاح واحد. Cursor، LangChain، و openai SDK — عبر تنسيق OpenAI. Claude Code — عبر تنسيق Anthropic، مباشرة وبدون وكيل. لا يقدم أي منافس ذلك.
3. استدعاء الأدوات (tool calling) الأصلي: تدعم جميع نماذج الشبكة استدعاء الدوال في كلا التنسيقين — OpenAI و Anthropic. الوكلاء، السلاسل، والأتمتة — كل شيء يعمل بشكل موثوق.
4. بداية مجانية: 3M رمز عند التسجيل. هذا يكفي لأسابيع من الاختبار وعمليات التكامل الأولى — بدون دفع.
5. دفع مرن: GNK (عمولة 0%)، WGNK من Ethereum (1%)، 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، ويتم إضافة الرصيد فوراً.
• شحن WGNK: عمولة 1%. بالنسبة لـ GNK على شبكة Ethereum — يتم إضافة التحويل تلقائياً.
• شحن USDT: عمولة 5%. تدفع باستخدام USDT (عبر OxaPay)، ويقوم Gateway بالتحويل إلى GNK تلقائياً. نسبة 5% هي رسوم مقابل الراحة (لا حاجة لمحفظة Gonka للعملات الرقمية).
• شحن العملات الورقية (Fiat): عبر On-Ramp (بطاقة ← USDT ← GNK). تعتمد العمولة على مزود خدمة On-Ramp.

عمولة المنصة: يتم تطبيق عمولة 10% على التكلفة الأساسية للاستدلال (inference) في شبكة Gonka. هذه العمولة مشمولة بالفعل في السعر النهائي ~$0.0069/1M رمز. التكلفة الأساسية في الشبكة هي ~$0.0046/1M، مع العمولة تصبح ~$0.0069/1M. تغطي العمولة تكاليف البنية التحتية لـ Gateway (خوادم، قواعد بيانات، مراقبة).

كيف يتم احتساب الاستهلاك: كل طلب API (سواء عبر صيغة OpenAI أو صيغة Anthropic) يستهلك رموزاً من الرصيد الموحد. يقوم Gateway بحساب prompt_tokens (المدخلات) + completion_tokens (المخرجات) ويخصمها من الرصيد. التكلفة: $0.0069 لكل 1M رمز (~0.003 GNK بالسعر الحالي). مفتاح واحد، رصيد واحد — لكلا صيغتي الـ API.

استدعاء الأدوات (Tool calling): استدعاءات الوظائف (tools) تستهلك أيضاً رموزاً — تضاف تعريفات الوظائف إلى الـ prompt. طلب استدعاء الأداة المعتاد يستهلك 1.5-3 أضعاف الرموز مقارنة بالطلب العادي — لكن بسعر $0.0069/1M يظل الأمر زهيداً جداً.

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

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

بارامترات النموذج: نافذة السياق — 200K رمز في MiniMax M2.7، و380K في DeepSeek V4 Flash، و390K في GLM-5.3 Flash. الحد الأقصى لطول الرد — يصل إلى 8192 رمزاً (في DeepSeek V4 Flash — يصل إلى 32768؛ الافتراضي بدون max_tokens هو 1500). بارامترات API المدعومة: model، messages، max_tokens، temperature، tools، tool_choice، stream.