ShareAI Platform Docs

إعادة ترتيب المستندات

قدم استعلامًا و1–1000 مستند.

عرض كـ Markdown
في هذه الصفحة
POST https://api.shareai.now/api/v1/rerank

إعادة ترتيب المستندات

عنوان URL الأساسي
https://api.shareai.now
المصادقة
مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
النطاق المطلوب
inference or monetization_gateway

قدم استعلامًا و1–1000 مستند. كل مستند هو نص، {"text":"..."} كائن أو كائن مدعوم من النموذج. {"image":"https://..."} يجب أن يكون على الأقل 1 ولا يزيد عن عدد المستندات. طابق النتائج مع مؤشرات المستندات الأصلية. top_n قم بتعيين SHAREAI_API_KEY على الخادم الخاص بك واستبدل عنصر النماذج بموديل مفعل حاليًا. لا تكشف أبدًا عن مفتاح API في كود المتصفح. يجب أن يسمح النموذج والحساب والبيانات الاعتمادية والمزود بهذه العملية. الإعدادات الاختيارية أدناه تتطلب دعم النموذج؛ حدود أمان API ليست وعدًا بأن كل نموذج يدعم كل قيمة.

قبل أن تبدأ#

المعنى والحدود.

إرسال طلب#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/rerank" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_RERANK_MODEL",
  "query": "A cat",
  "documents": [
    {
      "text": "A cat on a windowsill."
    },
    {
      "text": "A map of Berlin."
    }
  ],
  "top_n": 1
}'

حقول الطلب#

الحقلالنوعمطلوب
model سلسلة نصيةمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.استعلام ذو صلة غير فارغ.
query سلسلة نصيةمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.1–1000 سلسلة نصية غير فارغة أو كائنات نص/صورة ذات مفتاح واحد. يجب أن تكون قيم الصور روابط HTTPS أو روابط بيانات صور مدعومة، مع دعم إدخال الصور للنموذج.
documents سلسلة نصيةمصفوفةعدد صحيح.
top_nعدد النتائج الاختياري من 1 إلى عدد المستندات. تشير المؤشرات المرجعة إلى مصفوفة المستندات الأصلية.تضمين اختياري للمستندات الأصلية المدعومة من المزود في النتيجة.
return_documentsمنطقيكائن.
providerتفضيلات توجيه المزود الاختيارية. استخدم provider.only للعلامات المقبولة للمزود، وليس بادئة في معرف النموذج. لا تزال قيود الحساب والبيانات الاعتمادية سارية.النجاح يعيد HTTP 200 مع JSON. قدم استعلامًا و1–1000 مستند. كل مستند هو نص،.

قراءة النتيجة#

يمكن أن تستخدم معدلات إعادة الترتيب رموز الإدخال، المستندات المسجلة، الطلبات أو كمية البحث المبلغ عنها من المزود. لا يُفترض وجود تحويل عالمي من البحث إلى الرموز. المزود الذي لا يمكنه الإبلاغ عن بُعد مُسعر غير متاح لهذا التعريفة. {"text":"..."} كائن أو كائن مدعوم من النموذج. {"image":"https://..."} يجب أن يكون على الأقل 1 ولا يزيد عن عدد المستندات. طابق النتائج مع مؤشرات المستندات الأصلية. top_n قم بتعيين SHAREAI_API_KEY على الخادم الخاص بك واستبدل عنصر النماذج بموديل مفعل حاليًا. لا تكشف أبدًا عن مفتاح API في كود المتصفح. يجب أن يسمح النموذج والحساب والبيانات الاعتمادية والمزود بهذه العملية. الإعدادات الاختيارية أدناه تتطلب دعم النموذج؛ حدود أمان API ليست وعدًا بأن كل نموذج يدعم كل قيمة.

وحدات الفوترة#

اختر معرف النموذج المفعل بالضبط من Console. يجب أن تتطابق العملية المعلنة وقدرات الإدخال/الإخراج مع نقطة النهاية هذه؛ لا يمكن استبدال نموذج دردشة نصي بعملية أخرى. لا تزال قيود بيانات الاعتماد والمزود والحساب سارية.

يتم نشر الأسعار بعملة EUR AI credits للنموذج المحدد، المزود، الوحدات والمتغيرات. يتم فرض الرسوم فقط على الأبعاد في التعريفة النشطة. يحتفظ التقدير بالاعتمادات قبل التنفيذ؛ تستخدم الرسوم النهائية الاستخدام المقاس. يمكن أن تعتمد الأسعار على الدقة، تنسيق الإخراج أو نطاق الاستخدام. تحقق من Console Usage للحصول على الخصم النهائي من ShareAI. لا يتم تحويل حقول التكلفة الأولية والوسائط إلى عدد رموز مُخترع.

التسعير والاستخدام#

لتوجيه تكلفة الشبكة المعتمدة أو.

الوصول والأخطاء#

استخدم inference لزيادة معتمدة من Builder وشروط الفوترة المقبولة. الوصول بالهوية فقط لا يصرح بالإنفاق. التحقق، تفويض النموذج، الاعتمادات غير الكافية، حدود المعدل وفشل التنفيذ تعيد هيكلًا monetization_gateway . بعد انتهاء المهلة أو تقديم غير مؤكد، تحقق من الاستخدام أو مهمة الفيديو قبل إنشاء طلب آخر قد يكون مدفوعًا. error. آخر تحديث نوفمبر 3, 2026.

رابط إلى وحدات الفوترة

مستندات منصة ShareAI
جميع المستندات

البحث حسب العنوان أو المحتوى.

اسأل عن هذه الصفحة

اختر مساعدًا لاستكشاف هذه الصفحة. يمكنك أيضًا نسخ الصفحة ولصقها في محادثتك.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI