بوابة API للذكاء الاصطناعي
رمز وصول واحد لـClaude وGPT وGemini وQwen، مع توافق SDK الرسمية لكل مزود؛ يتطلب الانتقال عادةً تغيير سطرين فقط: base_url وapi_key.
- توافق البروتوكولات: استدعِ بروتوكولات OpenAI وAnthropic وGemini الأصلية مباشرةً دون إعادة كتابة
- البث: دعم كامل لبث SSE؛ يعتمد زمن ظهور أول رمز على الشبكة والنموذج والمزود
- دليل النماذج: النماذج المتاحة ونوافذ السياق والقدرات (الرؤية / الأدوات / التفكير)
- الاستخدام والفوترة: فوترة حسب الرموز مع تفاصيل الاستخدام لكل مفتاح
بوابة موحّدة بـ3 مداخل بروتوكول رسمية، Anthropic / OpenAI / Gemini، ويمكن بأيّ من الصيغ الثلاث استدعاء جميع نماذج البوابة. التكلفة = الرموز × السعر الرسمي × معامل مجموعة التسعير التي يستخدمها مفتاحك، دون رسم شهري ثابت.
المعلومات الأساسية
- Authorization: Bearer sk-nc-... يدعم Gemini أيضًا x-goog-api-key / ?key=
- بعد الدخول أنشئه في «خدمات الذكاء الاصطناعي ← مفاتيح API»
- السعر الرسمي بالدولار لكل MTok × معامل مجموعة التسعير؛ وإذا كانت للمجموعة ساعات خارج الذروة، تُضرب الطلبات المرسلة خلالها أيضًا في معامل خارج الذروة. ويُخصم مسبقًا من الرصيد؛ وتُسوّى الاستدعاءات المتدفقة بشكل غير متزامن عند انتهائها
- يُدعم GPT عبر SDK Anthropic وClaude عبر SDK OpenAI؛ تحوّل البوابة البروتوكولات تلقائيًا.
3 تنسيقات استدعاء
Anthropic /v1/messages
بروتوكول Claude messages مع SDK شائعة @anthropic-ai/sdk / anthropic لـPython
OpenAI /v1/chat/completions
بروتوكول OpenAI، يدعم tools / البث / الوسائط المتعددة
Gemini /v1beta/models/...
بروتوكول Gemini الأصلي، النموذج بالمسار يحدّد التوجيه
مستويات الخدمة والسرعة
تمرّر البوابة الطلبات دائمًا بالمستوى القياسي وتحتسب السعر القياسي؛ لا توجد مستويات مخفّضة أو أسرع:
- يُحذف service_tier (flex / fast / priority وغيرها) من جسم الطلبات بصيغة OpenAI
- يُحذف speed (الوضع السريع) من جسم الطلبات بصيغة Anthropic
- الترويسة X-Service-Tier بلا أثر؛ تُعالج الطلبات التي ترسلها بالمستوى القياسي
رموز الأخطاء
- 401 — مفتاح خاطئ أو معطّل
- 402 insufficient_balance — الرصيد غير كافٍ: الرصيد المتاح (بعد الرسوم غير المسوّاة) ≤ 0 أو لا يكفي للمبلغ المحجوز لهذا الطلب (يُقدَّر من حدّي السياق والمخرجات للنموذج، ويُضاف «الحد الأقصى لعمليات البحث × سعر الوحدة» عند استخدام البحث على الويب من جهة الخادم)؛ وتذكر رسالة الخطأ الحجز المطلوب والمتاح حاليًا. اشحن ثم أعد المحاولة. عندما ينخفض الرصيد المتاح عن 5$ تحمل الاستجابات X-Tovanix-Balance-Low: 1 و X-Tovanix-Balance-Available (بالدولار) لتنبيهك مبكرًا
- 402 quota_exceeded — تم بلوغ حد الإنفاق الشهري للمفتاح؛ يُعاد ضبطه في الشهر التالي. ويمكنك أيضًا تعديله عبر «تغيير الحد» في صفحة «مفاتيح API» في وحدة التحكم (يتطلّب التحقق من هويتك)
- 403 group_unavailable — عُطّلت مجموعة التسعير التي يستخدمها هذا المفتاح لمزوّد النموذج. غيّر مجموعة المفتاح من صفحة مفاتيح API؛ لا تنتقل البوابة إلى مجموعة أخرى من تلقاء نفسها
- 503 no_upstream_available — لا يوجد مسار متاح للنموذج في مجموعة التسعير التي يستخدمها مفتاحك (المسارات معطّلة أو في تهدئة مؤقتة). أعد المحاولة لاحقًا، أو غيّر مجموعة المفتاح من صفحة مفاتيح API إن كان لهذا المزوّد عدة مجموعات
- 502 — خدمة النموذج غير متاحة مؤقتًا أو أعادت استجابة تعذّر تحليلها؛ أعد المحاولة لاحقًا
نقاط أخرى
إضافة للمحادثة تتاح:
GET /v1/models
قائمة نماذج قابلة للتوجيه متوافقة مع OpenAI وmodels.list()
POST /v1/embeddings
تضمينات نص متوافقة مع OpenAI، input لمتجهات ورسوم لكل رمز
أمثلة Python / Node.js
للتجربة والأسعار والسجلات، افتح مركز المستخدم ← خدمات الذكاء الاصطناعي.
الأسئلة الشائعة
ما مقدار تغييرات الكود عند الانتقال من API لمزود؟
عادةً base_url وapi_key فقط. تتوافق البوابة مع SDK والبروتوكولات الرسمية؛ تبقى أجسام الطلبات وبنية الاستجابات وصيغ البث كما هي.
هل البث مدعوم؟
نعم. بث SSE مدعوم بالكامل، ويعمل stream=true مباشرةً من SDK الرسمية. يعتمد زمن ظهور أول رمز على الشبكة والنموذج والمزود، لذلك لا يُضمن أن يطابق الاستدعاء المباشر.
صفحات ذات صلة: خدمات الذكاء الاصطناعي · وثائق الواجهة البرمجية · حل الذكاء الاصطناعي العالمي
جارٍ التحميل…