تخطَّ إلى المحتوى
الأدلة
الأدلة

البدء السريع

استدع نماذج اللغة في RunAPI عبر بروتوكول متزامن أو دفقي مدعوم.

عرض Markdown

يعرض RunAPI نماذج اللغة من خلال أشكال البروتوكول العامة المألوفة. وجِّه عميلاً متوافقاً موجوداً إلى https://runapi.ai، واستخدم معرّف نموذج RunAPI، وتحقَّق بمفتاح API قياسي.

اختر بروتوكولاً

  • يستخدم Chat Completions المتوافق مع OpenAI المسار POST /v1/chat/completions.
  • يستخدم Responses المتوافق مع OpenAI المسار POST /v1/responses.
  • يستخدم Messages المتوافق مع Anthropic المسار POST /v1/messages.
  • يستخدم توليد المحتوى المتوافق مع Gemini المسار /v1beta/models/{model}:generateContent أو :streamGenerateContent.

اختر البروتوكول الذي يتوافق بشكل أفضل مع عميلك الحالي وتدفق تطبيقك. يُحدّد كتالوج النماذج البروتوكولات العامة التي يدعمها كل نموذج.

إرسال طلب

يُعيد طلب Chat Completions هذا استجابة متزامنة واحدة:

SHELL 
curl "https://runapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "Summarize why idempotency matters."}]
  }'

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

بث الإخراج

عيِّن خيار البث للبروتوكول واستهلك أحداث الخادم المُرسَلة المُعادة بشكل تدريجي. بالنسبة لـ Chat Completions، أضف "stream": true؛ وبالنسبة للاستدعاءات المتوافقة مع Gemini، استخدم عملية :streamGenerateContent. أغلق الدفق عندما يتلقى عميلك الحدث النهائي للبروتوكول.

فحص دقة التسليم

تتضمن كل استجابة LLM مقبولة الرأسَ X-RunAPI-Fidelity. تعني القيمة full أن الطلب سُلِّم دون حذف. وتعني القيمة lossy أن RunAPI حذفت ضوابط اختيارية لإتمام الطلب؛ ويحتوي X-RunAPI-Omitted-Fields على أسماء الحقول المحذوفة مفصولةً بفواصل. تُرفض الطلبات التي لا يمكن الحفاظ فيها على دلالات دورة الحياة الإلزامية أو الاستمرارية أو الأدوات أو العناصر المكتوبة قبل إنشاء مهمة Task.

يظهر كلا الترويستين عبر CORS، لذا يمكن لعملاء المتصفح فحصهما. سجّلهما مع معرّف الطلب عندما تكون سلوكيات التسليم الدقيقة مهمة للتطبيق.

معالجة الأخطاء والاستخدام

عامِل 401 على أنه فشل مصادقة، وردود 4xx على أنها مشكلات في الطلب أو السياسة، وأعد المحاولة فقط في حالات فشل الخادم أو الشبكة العابرة. اقرأ استخدام الرموز من الاستجابة النهائية أو حدث البث النهائي في شكل البروتوكول المحدد، واحتفظ بمعرّفات الطلبات في سجلات التطبيق للدعم الفني.