شرح واجهة برمجة تطبيقات OpenAI Gateway بمصطلحات واضحة

ما تعنيه العبارة عادةً

عندما يبحث شخص ما عن واجهة برمجة تطبيقات بوابة OpenAI، فإنه يريد عادةً أحد ثلاثة أشياء، ونادراً ما يوضح أيها. فرزها أولاً يوفر الكثير من الالتباس، لأن الثلاثة لها وظائف مختلفة وتكاليف مختلفة.

المعنى	ما يفعله	السبب المعتاد لرغبتك فيه
وكيل أو موجّه تشغله	يوجد في بنية التحتية الخاصة بك، يستقبل الطلبات بتنسيق OpenAI ويعيد توجيهها إلى مزود واحد أو أكثر	مفاتيح مركزية، تسجيل، استراتيجيات بديلة، تتبع الإنفاق لكل فريق
خدمة مستضافة متعددة المزودين	طرف ثالث يدير طبقة التوجيه هذه نيابة عنك ويحاسبك مقابل ذلك	حساب واحد للعديد من النماذج، بدون خوادم تحتاج إلى صيانتها
نقطة نهاية متوافقة	يوفر مزود النموذج الخاص به خلف نفس تنسيق الطلب والاستجابة	أعد استخدام كود SDK الحالي مع نموذج مختلف أو قواعد محتوى مختلفة

كلمة "بوابة" تأتي من الشبكات وإدارة واجهات برمجة التطبيقات، حيث تعني باباً أمامياً يتحقق من بيانات الاعتماد، يطبق الحدود ويمرر حركة المرور. عند تطبيقها على نماذج اللغة، يتحدث الباب الأمامي بالتنسيق الذي نشرته واجهة إكمال الدردشة الخاصة بـ OpenAI: جسم JSON يحتوي على اسم النموذج وقائمة من الرسائل، ورمز Bearer في الرأس، وإجابة JSON تحتوي على الخيارات واستخدام الرموز. نظراً لكتابة الكثير من الأدوات لهذا التنسيق، فإن العديد من الخوادم تحاكيه الآن.

أين ينتمي هذا الموقع

ينتمي هذا الموقع إلى الصف الثالث، وليس الأولين. إنه واجهة برمجة تطبيقات مستضافة تعرض نموذج واحد مفتوح الأوزان عبر تنسيق طلب OpenAI. يتم تشغيل النموذج بواسطة مزود مستقل وضبطه للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. تختاره باستخدام معرف النموذج uncensored.

هذا يحتاج إلى توضيح، لأن اسم النطاق قد يوحي بأكثر مما يقدمه:

• إنها ليست واجهة برمجة التطبيقات الرسمية لـ OpenAI، Meta، Mistral، Qwen، DeepSeek، xAI، Google، Anthropic أو أي مورد آخر.
• إنه ليس مُوَجِّهاً عبر البائعين. لا يتم إرسال أي طلب إلى نموذج شركة أخرى. كل استدعاء يذهب إلى نفس النموذج.
• هي للنص فقط. لا يوجد توليد صور أو صوت أو فيديو، ولا تضمينات (embeddings)، ولا ضبط دقيق (fine-tuning).
• يدعم POST /v1/chat/completions و GET /v1/models، ولا شيء يتجاوز هذين الأمرين.

ما تحصل عليه هو الواجهة المألوفة: البث المتدفق عبر SSE، استدعاء الدوال، وضع JSON، ومعاملات أخذ العينات المعتادة. نافذة السياق هي 100,000 رمز، تحسب المطالبة والإكمال معاً. التفاصيل في مستندات API.

لماذا التوافقية في الواجهة هي الجزء المفيد

القيمة الأكبر في فكرة نقاط النهاية المتوافقة هي أن تكلفة التبديل تنخفض إلى ما يقرب من الصفر. إذا كان الكود الخاص بك يعمل مع خادم على طراز OpenAI، فإن توجيهه إلى خادم آخر يتطلب تغيير إعدادات بدلاً من إعادة كتابة الكود. تقوم بتغيير عنوان URL ومفتاح API، وتغير اسم النموذج.

إليك كيف يبدو ذلك باستخدام curl، مما يسهل رؤية الأجزاء المتحركة:

Copycurl https://api.openaigatewayapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in three languages."}]
  }'

ونفس الشيء عبر مكتبة Python SDK، حيث يعرف المُنشئ فقط عن الخادم:

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openaigatewayapi.com/v1", api_key="paste-your-key-here")

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Say hello in three languages."}],
)
print(reply.choices[0].message.content)

هذا هو السبب أيضًا في أن طبقة البوابة ونقطة النهاية المتوافقة غالباً ما يتم الخلط بينهما. من جانب العميل، تبدو متطابقة: نفس المسار، نفس الرؤوس، نفس JSON. الفرق يكمن خلف الباب. يقوم الموجه باختيار النموذج الذي يجيب على كل طلب. تستخدم نقطة النهاية المتوافقة دائماً النموذج الذي تستضيفه.

عندما تحتاج إلى طبقة بوابة حقيقية

التوافق وحده لا يمنحك الميزات التي يقصدها الناس عند الحديث عن تشغيل بوابة. إذا كان أي مما يلي ينطبق عليك، فخطط لطبقة منفصلة بدلاً من توقعها من نقطة نهاية واحدة:

• التراجع التلقائي. إعادة المحاولة على مزود آخر عندما يفشل الأول.
• ميزانيات لكل فريق ومفاتيح. إصدار العديد من المفاتيح الداخلية، لكل منها حدّه الخاص، من حساب طرف بعيد واحد.
• تسجيل الطلبات وإخفاء البيانات. سجّل الموجّهات والاستجابات مركزياً، مع إزالة الحقول الحساسة.
• التوجيه حسب المهمة. نموذج رخيص للتصنيف، نموذج أكبر للاستدلال، يتم اختياره حسب قواعده الخاصة بك.
• التخزين المؤقت. أعد الإجابات المخزنة للموجّهات المتكررة.

هذه أسباب جيدة، وغالباً ما يكون الوكيل المستضاف ذاتياً هو الإجابة الصحيحة لفريق لديه عدة مزودين. كما يضيف خدمة للنشر والمراقبة والأمان، وهو تكلفة يسهل التقليل من تقديرها لمشروع صغير. تذهب الصفحة حول مقايضات تشغيل بوابة LLM في تفاصيل أكثر حول هذا القرار.

تتلاقى الفكرتان دون مشكلات. يمكن للوكيل الذي تشغله أن يدرج نقطة النهاية هذه كـ نقطة وصول علوية واحدة، مع uncensored كنموذج يقوم بإعادة التوجيه إليه. في هذا الإعداد، سجّل رأس الاستجابة X-Request-Id من جانبك. هذه هي القيمة التي يجب ذكرها إذا احتجت إلى مساعدة في تتبع مكالمة محددة.

القيود والسلوك الذي يجب أن تخطط له

نقطة النهاية المستضافة المفردة بسيطة، ولكن لها حواف يجب أن تعرفها قبل البناء عليها.

حدود المعدل والتزامن

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. المفتاح التجريبي يسمح بـ 2 متزامن و60 في الدقيقة. عند تجاوز الحد، تجيب الـ API بـ HTTP 429 مع رمز الخطأ rate_limited أو concurrency. أثناء الحمل الزائد المؤقت، تجيب أيضاً بـ 429، مع رأس Retry-After: 5. يحافظ الطلب المتدفق على مكانه حتى ينتهي البث، لذا فإن التوليدات الطويلة تحسب ضد التزامن طوال مدتها.

حجم الطلب

الحد الأقصى لحجم نص الطلب هو 8 ميجابايت. في الممارسة العملية، فإن نافذة الـ 100,000 رمز هي الحد الأكثر تشدداً لمعظم الموجّهات. إذا قمت بحشو سجل دردشة طويل في كل مكالمة، قم بقصه قبل الوصول إلى أي من السقفين.

الملاحظة

تشمل كل استجابة X-Request-Id و X-Balance-USD، بالإضافة إلى رؤوس تعكس طلبك وحدود التزامن. سجلها. يمكن للبوابة التي تبنيها لاحقاً قراءة نفس الرؤوس، لذا لا تخسر شيئاً بالبدء بها.

أسئلة يجب طرحها حول أي بوابة أو API متوافق

قائمة التحقق نفسها تعمل سواء كنت تقيم هذه الخدمة، أو موزع مستضاف، أو وكيل مستضاف ذاتياً. اكتب الإجابات قبل الالتزام بالكود بأي منها.

1. أي نموذج يجيب؟ بائع مسمى، نموذج مفتوح الأوزان على مضيف مستقل، أو أي شيء يختاره الموجه في تلك الدقيقة.
2. ما هي وحدة السعر؟ لكل رمز، لكل طلب، أو شهرياً. هنا هو لكل رمز، رصيد مسبق الدفع.
3. ماذا يحدث عند الفشل؟ هنا، لا تُحتسب أي رسوم على الطلبات الفاشلة أو المرفوضة.
4. ما هي الميزات الحقيقية؟ اختبر البث المتدفق، والأدوات، ووضع JSON مع حمولاتك الخاصة، وليس مع موجّه تجريبي.
5. إلى أين تذهب الموجّهات؟ هنا لا تُستخدم للتدريب. اقرأ صفحة الخصوصية للمزيد من التفاصيل وقارنها مع أي بديل.
6. ما هي الحدود الصارمة؟ التوازي، الطلبات في الدقيقة، حجم نص الطلب ونافذة السياق.

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

طريقة معقلة للبدء

اجعل الاختبار الأول صغيراً. احجز التجربة، واستدعي GET /v1/models لتأكيد المفتاح، ثم أرسل ثلاثة موجّهات حقيقية من تطبيقك مع تغيير عنوان URL الأساسي. قارن الإجابات مع ما تحصل عليه اليوم، تحقق من رؤوس الاستجابة، وانظر إلى عدد الرموز في usage. إذا كان المخرج يناسب والحدود تناسب حركة المرور الخاصة بك، انقل ميزة منخفضة المخاطر قبل الباقي. الأدوات الداخلية ومساعدات الصياغة والوظائف الخلفية تجعل مرشحين أوليين جيدين، حيث أن نقطة الضعف هناك تكلفك أقل بكثير من واحدة في سير عمل موجه للعملاء.

إذا قررت لاحقاً أنك بحاجة إلى التوجيه أو التراجع، فلن تذهب جهودك هباءً. يبقى تنسيق الطلب كما هو، ويمكن إضافة طبقة وسيطة أمامها دون تغيير كود التطبيق.

المزيد من الأدلة

• OpenAI API للمطورين: استخدم نقطة نهاية متوافقة
• أسعار واجهة برمجة تطبيقات بوابة OpenAI: أمثلة على التكلفة الحقيقية
• بوابة LLM: تحليل التكلفة مقابل التعقيد