إعادة ترتيب النتائج قريبًا

يرتب قائمة مستندات وفق صلتها باستعلام.

POST https://api.cloudzir.com/v1/rerank

المصادقة#

Authorization: Bearer zir_ai_<48 caractères hexadécimaux>
Content-Type: application/json

المعاملات#

الحقلالنوعالوصف
query إلزاميstringنص غير فارغ للمقارنة.
documents إلزاميarray من stringsقائمة غير فارغة من نصوص غير فارغة.
modelstringmina-rerank، القيمة الافتراضية.
top_nintegerعدد النتائج من 1 إلى عدد المستندات. القيمة الافتراضية هي كل المستندات.

الطلب#

curl https://api.cloudzir.com/v1/rerank \
  -H "Authorization: Bearer $CLOUDZIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"énergie solaire","documents":["charbon","photovoltaïque"],"top_n":1}'

الاستجابة المتوقعة عند تفعيل القدرة#

الحقلالوصف
results[]الفهرس الأصلي ودرجة الصلة من 0 إلى 1 ونص المستند.
usageرموز الاستعلام والمستندات كما يعيدها المحرّك.
قريبًا

لا يوجد محرّك لإعادة الترتيب مسجّل في هذا الإصدار. بعد التحقق من المفتاح والجسم، يعيد المسار 501 إلى حين توصيل محرّك. لا ننشر هنا سعرًا أو موعدًا للتوفر.

الأخطاء والحدود#

400، 401، 402، 403، 404، 413، 429، 500، 501، 503. يضبط الخادم عدد المستندات والرموز لكل نص والإجمالي. انظروا أكواد الأخطاء والنماذج والأسعار.

الإعدادات

استجابة API