إعادة ترتيب المستندات
قدم استعلامًا و1–1000 مستند.
في هذه الصفحة
https://api.shareai.now/api/v1/rerankإعادة ترتيب المستندات
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
- النطاق المطلوب
inferenceormonetization_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
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_RERANK_MODEL',
'query': 'A cat',
'documents': [{'text': 'A cat on a windowsill.'},
{'text': 'A map of Berlin.'}],
'top_n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/rerank', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/rerank", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_RERANK_MODEL",
"query": "A cat",
"documents": [
{
"text": "A cat on a windowsill."
},
{
"text": "A map of Berlin."
}
],
"top_n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);حقول الطلب#
| الحقل | النوع | مطلوب |
|---|---|---|
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.
رابط إلى وحدات الفوترة