مواصفات API

أرسل طلبًا أول، واختر نموذجًا من الكتالوج، واحتفظ بمعرّف طلب للتشخيص.

أرسل مفتاح API في ترويسة Bearer وأبقِ بيانات اعتماد الإنتاج منفصلة عن بيانات اعتماد التطوير.

استخدم عناوين URL أساسية مختلفة لعملاء أسلوب OpenAI وMessages: فكلاهما يستهدف مواصفة واحدة لكنهما يكوّنان المسارات بصورة مختلفة.

اضبط عميلًا بمفتاح ونموذج وعنوان URL أساسي يطابق بروتوكوله؛ وأبقِ السر في البيئة.

إجابات عملية موجزة عن المفاتيح وعناوين URL الأساسية والنماذج والتكلفة وتشخيص التكامل.

ابنِ اختيار النماذج من بيانات الكتالوج بدلًا من قائمة ثابتة في تطبيقك.

افصل المفاتيح والمالكين والميزانيات وآثار الاستخدام بين التطبيقات ومساحات العمل.

اعتبر حدود المفتاح والمؤسسة والنموذج والتوجيه جزءًا من سير عمل المستخدم.

اربط البيانات الوصفية للاستجابة وسجلات طلباتك بإجراءات المستخدم الحقيقية.

قلل البيانات المنقولة، وافصل معرّف المستخدم النهائي عن المحتوى، واضبط الاحتفاظ في منتجك.

أنشئ محادثات متعددة الأدوار بتنسيق messages المألوف واختر نموذجًا لكل طلب.

استخدم تنسيق Messages للمحادثات التي تتضمن تعليمة system في المستوى الأعلى وحد مخرجات صريحًا.

استخدم كائن input واحدًا عندما يستفيد تطبيقك من معالجة عناصر المخرجات والإجراءات في نموذج بيانات واحد.

استقبل الرموز والدلتا المنظّمة عبر SSE من دون انتظار الاستجابة الكاملة.

صِف الدوال باستخدام JSON Schema، ونفّذ الاستدعاء في تطبيقك، وأعد النتيجة إلى المحادثة.

اطلب كائن JSON أو JSON Schema عندما ستستهلك البرمجيات الاستجابة بدلًا من شخص.

اضبط جهد الاستدلال لكل طلب فقط للنماذج التي تعلن هذه الإمكانية.

عبّر عن متطلبات التنفيذ في تفضيلات المزوّد واحتفظ بالنتيجة الفعلية لقابلية الرصد.

افصل السياق المتكرر كي يتمكن العميل من استخدام التخزين المؤقت المتوافق حيث يدعمه النموذج المختار.

استرجع مصادر حديثة عبر دالة `web_search` ينفذها العميل، وأبقِ الروابط منفصلة عن النص المنشأ.

ارفع ملفًا عبر عملية مخصصة، واحتفظ بمعرّفه، ومرر مرجعًا إليه في طلب متوافق لاحق.

أنشئ الصور عبر مسار واحد واختر المعلمات من إمكانات النموذج المختار.

ابدأ إنشاء الفيديو كمهمة غير متزامنة، واحتفظ بمعرّف المهمة، وأبقِ الإنشاء منفصلًا عن قراءة النتيجة.

استخدم عمليات منفصلة لتوليف الكلام والنسخ الصوتي والإدخال الصوتي إلى نموذج.

حوّل النص أو المدخلات المدعومة إلى متجهات للبحث والتجميع والتوصيات.

أعد ترتيب مجموعة صغيرة من المرشحين وفق استعلام لتحسين دقة الاسترجاع النهائي.

عالج العمليات المستقلة في مجموعات مضبوطة عندما يسمح سير العمل بالتسليم غير المتزامن.

صِل عميل ذكاء اصطناعي بالأدوات والموارد والمطالبات المسموح بها عبر عنوان URL للاتصال صادر من إعدادات الحساب.

ابنِ المعالجة حول حالة HTTP ونص خطأ منظّم ومعرّف الطلب، لا حول نص الرسالة.