الانتقال إلى المحتوى الرئيسي
POST
إعادة ترتيب المستندات
استخدم هذا المسار لإعادة ترتيب المستندات المرشحة قبل تمريرها إلى البحث أو الاسترجاع أو التوليد. تحقق من النموذج عبر GET /v1/models قبل النشر. تتضمن الاستجابة الافتراضية النماذج ذات مسار Gateway عام فقط.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

الجسم

application/json
model
string
مطلوب
query
string
مطلوب
documents
مطلوب
Minimum array length: 1
models
string[]

نماذج احتياطية اختيارية ومرتبة تُجرَّب بعد model. الحقل model مطلوب وهو دائمًا النموذج الأساسي. عندما تفشل محاولة بالرمز 429 أو 500 أو 502 أو 503 أو 504، تُجرَّب الإدخالة التالية؛ وتُعاد الأخطاء الأخرى دون تغيير. يقبل ما يصل إلى 25 معرّف نموذج أو إعدادًا مسبقًا؛ وتُتجاهل الإدخالات المكررة والإدخالات المطابقة لـ model. يُتحقق من كل محاولة وتُسجَّل وتُحتسب تكلفتها كطلب مستقل، ويعرض الحقل model في الاستجابة وتتبّع التوجيه النموذج الذي خدم الطلب. لا تنتقل طلبات البث إلى نموذج احتياطي إلا قبل إرسال البايت الأول، ولا تنتقل مهام الفيديو والموسيقى إلا عند الإرسال. ترفض طلبات batch وrealtime وcouncil الحقل models. تكون الأولوية للنماذج الاحتياطية المحددة في مسار ديناميكي، ولا يمكن الجمع بين phaseo/auto وmodels.

Required array length: 1 - 25 elements
Minimum string length: 1
مثال:
top_n
integer
النطاق المطلوب: x >= 1
top_k
integer

اسم مستعار لـ top_n.

النطاق المطلوب: x >= 1
return_documents
boolean
max_chunks_per_doc
integer
النطاق المطلوب: x >= 1
rank_fields
string[]
user
string
metadata
object
provider_options
object
debug
object

عناصر تحكم تصحيح أخطاء البوابة. لا تُمرر هذه العلامات إلى المزوّد مطلقًا.

provider
object

تفضيلات توجيه المزوّد لاختياره عبر البوابة.

الاستجابة

200 - application/json

استجابة إعادة الترتيب

object
string
id
string
nativeResponseId
string | null
model
string
results
object[]
usage
object
آخر تعديل في ١٦ نوفمبر ٢٠٢٦