{
  "aboutHtml": "<p>BGE Reranker v2 M3 نموذج متعدد اللغات لتقدير الصلة، مبني على BGE-M3. يتلقى استعلامًا ومقطعًا مرشّحًا معًا ويُرجع درجة للعلاقة بينهما. تقدّم BAAI هذا الإصدار بوصفه نموذجًا كفؤًا متعدد اللغات لإعادة الترتيب، بما يشمل الاسترجاع بالصينية والإنجليزية حين يحتاج تطبيق البحث إلى تحسين قائمة مرشحين موجودة.</p><h4>الصلة من زوج استعلام ومقطع</h4><p>يعالج المُرمِّز المتقاطع النصين معًا، مما يسمح بتفاعل محتواهما قبل إنتاج درجة الصلة. يختلف ذلك عن نموذج التضمين، الذي يرمّز النصوص بصورة مستقلة لمقارنة متجهات قابلة لإعادة الاستخدام. ناتج معيد الترتيب درجة عددية مفردة لزوج بعينه، وليس متجه مستند أو إجابة مكتوبة.</p><p>استخدم النموذج بعد أن يختار البحث الأولي مقاطع يُحتمل أن تكون مناسبة. اقرن السؤال بكل مرشّح ورتّب المرشحين وفق الدرجات الناتجة. يركّز ذلك المقارنة الأكثر تفصيلًا على قائمة مختصرة يسهل التعامل معها، بدل تكليف مُرمِّز متقاطع بفحص كل مقطع في مجموعة كبيرة.</p><h4>إصدار v2 M3</h4><p>تحدّد الشركة BGE-M3 بوصفه النموذج الأساسي، وتذكر الدعم متعدد اللغات كميزة رئيسية. ضمن عائلة معيدات الترتيب v2، يُعد M3 الخيار الكفء متعدد اللغات؛ أما الإصدارات المبنية على Gemma وإصدارات اختيار الطبقات فهي نماذج مستقلة ذات خيارات تنفيذ مختلفة. ولا يعني اسم M3 هنا أن معيد الترتيب يُرجع التضمينات الكثيفة والمتناثرة ومتعددة المتجهات الخاصة بنموذج التضمين الأصلي.</p><p>يهم هذا الفرق عند اختيار النتيجة التي يحتاجها تطبيقك. اختر نموذج تضمين لتمثيل مجموعة مستندات والبحث فيها. واختر معيد الترتيب هذا عندما يكون لديك نصوص مرشّحة وتحتاج إلى تحديد المقطع الأكثر صلة بالاستعلام الحالي.</p><h4>إعداد مرشحين يمكن ترتيبهم بصورة مفيدة</h4><p>قدّم السؤال الفعلي والنص الكامل للمرشّح اللازم لتفسيره. احتفظ بالعناوين أو التعريفات القريبة حين تحدّد معنى المقطع. في مثال Transformers المنشور، يُحوَّل الاستعلام والمقطع معًا إلى رموز مع الاقتطاع وmax_length=512. هذا إعداد للمثال وليس حدًا عامًا للنموذج. أبقِ السؤال والأدلة المطلوبة ضمن الميزانية المختارة للزوج، وتحقّق مما يزيله الاقتطاع. قد تذكر نتيجة المنتج نفسه الوارد في الاستعلام وتظل غير ذات صلة إذا تناولت عملية أو شرطًا غير المطلوب؛ جهّز أمثلة تميّز هذه الحالات عند تقييم جودة الاسترجاع.</p><p>في مساعد للمستندات، احتفظ بمعرّفات المرشحين إلى جانب نصوصهم، وقيّم أزواج السؤال والمقطع، ثم مرّر المقاطع الأصلية المختارة إلى خطوة الإجابة. يتلقى نموذج الإجابة حينئذ الأدلة بدل درجة صلة بلا مصدر. هذا مثال توضيحي لمسار استرجاع؛ أما معيد الترتيب نفسه فلا يبحث في مجموعة خارجية ولا يكتب الإجابة.</p><h4>قراءة الدرجات وتطبيعها</h4><p>تُرجع الشركة درجات صلة خامًا، وتشير القيمة الأعلى إلى تطابق أقرب. ويطبّق التطبيع الاختياري الموثّق دالة سيغمويد لجعل الدرجة بين 0 و1. يوفّر التطبيع نطاقًا ملائمًا، لكن هذا التحويل وحده لا يثبت احتمالًا معايرًا لصحة المرشّح.</p><p>اختر عتبات الترتيب أو التصفية باستخدام أزواج استعلام ومقطع ممثّلة لأعباء عملك. أدرج مقاطع تشترك في الكلمات المفتاحية لكنها تجيب عن سؤال مختلف، وكذلك مقاطع ذات صلة تستخدم صياغة مختلفة. يمنح ذلك العتبة المختارة معنىً للمجموعة التي يجري البحث فيها.</p><p>في مشروع يستخدم Ailoot API، حدّد ما ينبغي أن يتضمنه السياق النهائي وعدد المرشحين الذين يمكن فحصهم بكفاءة. النتيجة المفيدة مجموعة أدلة أفضل ترتيبًا لخطوة التطبيق التالية. افصل مخرجات الصلة في هذا الإصدار عن تضمينات المستندات والنصوص المولّدة وعناصر التحكم في اختيار الطبقات الموثّقة لمعِيدات ترتيب أخرى.</p>",
  "aboutText": "BGE Reranker v2 M3 نموذج متعدد اللغات لتقدير الصلة، مبني على BGE-M3. يتلقى استعلامًا ومقطعًا مرشّحًا معًا ويُرجع درجة للعلاقة بينهما. تقدّم BAAI هذا الإصدار بوصفه نموذجًا كفؤًا متعدد اللغات لإعادة الترتيب، بما يشمل الاسترجاع بالصينية والإنجليزية حين يحتاج تطبيق البحث إلى تحسين قائمة مرشحين موجودة.\n\n### الصلة من زوج استعلام ومقطع\n\nيعالج المُرمِّز المتقاطع النصين معًا، مما يسمح بتفاعل محتواهما قبل إنتاج درجة الصلة. يختلف ذلك عن نموذج التضمين، الذي يرمّز النصوص بصورة مستقلة لمقارنة متجهات قابلة لإعادة الاستخدام. ناتج معيد الترتيب درجة عددية مفردة لزوج بعينه، وليس متجه مستند أو إجابة مكتوبة.\n\nاستخدم النموذج بعد أن يختار البحث الأولي مقاطع يُحتمل أن تكون مناسبة. اقرن السؤال بكل مرشّح ورتّب المرشحين وفق الدرجات الناتجة. يركّز ذلك المقارنة الأكثر تفصيلًا على قائمة مختصرة يسهل التعامل معها، بدل تكليف مُرمِّز متقاطع بفحص كل مقطع في مجموعة كبيرة.\n\n### إصدار v2 M3\n\nتحدّد الشركة BGE-M3 بوصفه النموذج الأساسي، وتذكر الدعم متعدد اللغات كميزة رئيسية. ضمن عائلة معيدات الترتيب v2، يُعد M3 الخيار الكفء متعدد اللغات؛ أما الإصدارات المبنية على Gemma وإصدارات اختيار الطبقات فهي نماذج مستقلة ذات خيارات تنفيذ مختلفة. ولا يعني اسم M3 هنا أن معيد الترتيب يُرجع التضمينات الكثيفة والمتناثرة ومتعددة المتجهات الخاصة بنموذج التضمين الأصلي.\n\nيهم هذا الفرق عند اختيار النتيجة التي يحتاجها تطبيقك. اختر نموذج تضمين لتمثيل مجموعة مستندات والبحث فيها. واختر معيد الترتيب هذا عندما يكون لديك نصوص مرشّحة وتحتاج إلى تحديد المقطع الأكثر صلة بالاستعلام الحالي.\n\n### إعداد مرشحين يمكن ترتيبهم بصورة مفيدة\n\nقدّم السؤال الفعلي والنص الكامل للمرشّح اللازم لتفسيره. احتفظ بالعناوين أو التعريفات القريبة حين تحدّد معنى المقطع. في مثال Transformers المنشور، يُحوَّل الاستعلام والمقطع معًا إلى رموز مع الاقتطاع وmax_length=512. هذا إعداد للمثال وليس حدًا عامًا للنموذج. أبقِ السؤال والأدلة المطلوبة ضمن الميزانية المختارة للزوج، وتحقّق مما يزيله الاقتطاع. قد تذكر نتيجة المنتج نفسه الوارد في الاستعلام وتظل غير ذات صلة إذا تناولت عملية أو شرطًا غير المطلوب؛ جهّز أمثلة تميّز هذه الحالات عند تقييم جودة الاسترجاع.\n\nفي مساعد للمستندات، احتفظ بمعرّفات المرشحين إلى جانب نصوصهم، وقيّم أزواج السؤال والمقطع، ثم مرّر المقاطع الأصلية المختارة إلى خطوة الإجابة. يتلقى نموذج الإجابة حينئذ الأدلة بدل درجة صلة بلا مصدر. هذا مثال توضيحي لمسار استرجاع؛ أما معيد الترتيب نفسه فلا يبحث في مجموعة خارجية ولا يكتب الإجابة.\n\n### قراءة الدرجات وتطبيعها\n\nتُرجع الشركة درجات صلة خامًا، وتشير القيمة الأعلى إلى تطابق أقرب. ويطبّق التطبيع الاختياري الموثّق دالة سيغمويد لجعل الدرجة بين 0 و1. يوفّر التطبيع نطاقًا ملائمًا، لكن هذا التحويل وحده لا يثبت احتمالًا معايرًا لصحة المرشّح.\n\nاختر عتبات الترتيب أو التصفية باستخدام أزواج استعلام ومقطع ممثّلة لأعباء عملك. أدرج مقاطع تشترك في الكلمات المفتاحية لكنها تجيب عن سؤال مختلف، وكذلك مقاطع ذات صلة تستخدم صياغة مختلفة. يمنح ذلك العتبة المختارة معنىً للمجموعة التي يجري البحث فيها.\n\nفي مشروع يستخدم Ailoot API، حدّد ما ينبغي أن يتضمنه السياق النهائي وعدد المرشحين الذين يمكن فحصهم بكفاءة. النتيجة المفيدة مجموعة أدلة أفضل ترتيبًا لخطوة التطبيق التالية. افصل مخرجات الصلة في هذا الإصدار عن تضمينات المستندات والنصوص المولّدة وعناصر التحكم في اختيار الطبقات الموثّقة لمعِيدات ترتيب أخرى.",
  "editorialOverlay": {
    "copy_fields": null,
    "copy_sha256": null,
    "copy_source": null,
    "html_sha256": "a20f40143538b0912aca91265fb0924a855a45ef88cdabc8be2745e4a6314333",
    "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06",
    "raw_model_unchanged": true,
    "schema": "ailoot-native-model-editorial-v1"
  },
  "locale": "ar",
  "methods": [
    {
      "html": "<div class=\"sheet-head\"><span class=\"mav\" aria-hidden=\"true\">•</span><h2 id=\"sheet-title\">bge-reranker-v2-m3</h2><button class=\"icon-btn\" type=\"button\" data-close-sheet aria-label=\"إغلاق\">×</button></div><div class=\"idline\"><span>BAAI /</span><code>bge-reranker-v2-m3</code><button type=\"button\" id=\"copy-id\">نسخ ID</button></div><nav class=\"card-jump-nav\" aria-label=\"أقسام بطاقة النموذج\"><button type=\"button\" data-card-jump=\"overview\">البداية</button><button type=\"button\" data-card-jump=\"methods\">المدخلات والطرائق</button><button type=\"button\" data-card-jump=\"pricing\">الباقات</button><button type=\"button\" data-card-jump=\"examples\">أمثلة</button><button type=\"button\" data-card-jump=\"results\">النتائج</button><button type=\"button\" data-card-jump=\"aliases\">الأسماء البديلة</button></nav><div class=\"card-method-tabs\" role=\"tablist\" aria-label=\"طرائق API\"><button type=\"button\" role=\"tab\" tabindex=\"0\" aria-controls=\"card-method-content\" aria-selected=\"true\" id=\"card-method-tab-0\" data-card-method=\"Ultra|rerank|/v1/rerank|bge-reranker-v2-m3\">إعادة الترتيب</button></div><div id=\"card-method-content\" role=\"tabpanel\" aria-labelledby=\"card-method-tab-0\"><section class=\"card-section\" data-card-section=\"overview\"><h3 tabindex=\"-1\">البداية</h3><p class=\"mdesc-full\">مُرمِّز تقاطعي متعدد اللغات من BAAI لترتيب المقاطع المرشحة مقابل استعلام. يقرأ كل زوج من الاستعلام والمقطع معًا ويعيد درجة صلة، لتنقيح قائمة البحث المختصرة من دون توليد إجابة أو إنشاء تضمينات للمستندات.</p><dl class=\"card-io\" data-card-io><div><dt>المدخلات المقبولة</dt><dd>النص</dd></div><div><dt>النتائج</dt><dd>النتائج المرتبة</dd></div></dl><details class=\"card-about\"><summary>عن النموذج</summary><p class=\"note-s\" data-model-method-boundary>يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.</p><div class=\"mabout\" id=\"m-about\"><p>BGE Reranker v2 M3 نموذج متعدد اللغات لتقدير الصلة، مبني على BGE-M3. يتلقى استعلامًا ومقطعًا مرشّحًا معًا ويُرجع درجة للعلاقة بينهما. تقدّم BAAI هذا الإصدار بوصفه نموذجًا كفؤًا متعدد اللغات لإعادة الترتيب، بما يشمل الاسترجاع بالصينية والإنجليزية حين يحتاج تطبيق البحث إلى تحسين قائمة مرشحين موجودة.</p><h4>الصلة من زوج استعلام ومقطع</h4><p>يعالج المُرمِّز المتقاطع النصين معًا، مما يسمح بتفاعل محتواهما قبل إنتاج درجة الصلة. يختلف ذلك عن نموذج التضمين، الذي يرمّز النصوص بصورة مستقلة لمقارنة متجهات قابلة لإعادة الاستخدام. ناتج معيد الترتيب درجة عددية مفردة لزوج بعينه، وليس متجه مستند أو إجابة مكتوبة.</p><p>استخدم النموذج بعد أن يختار البحث الأولي مقاطع يُحتمل أن تكون مناسبة. اقرن السؤال بكل مرشّح ورتّب المرشحين وفق الدرجات الناتجة. يركّز ذلك المقارنة الأكثر تفصيلًا على قائمة مختصرة يسهل التعامل معها، بدل تكليف مُرمِّز متقاطع بفحص كل مقطع في مجموعة كبيرة.</p><h4>إصدار v2 M3</h4><p>تحدّد الشركة BGE-M3 بوصفه النموذج الأساسي، وتذكر الدعم متعدد اللغات كميزة رئيسية. ضمن عائلة معيدات الترتيب v2، يُعد M3 الخيار الكفء متعدد اللغات؛ أما الإصدارات المبنية على Gemma وإصدارات اختيار الطبقات فهي نماذج مستقلة ذات خيارات تنفيذ مختلفة. ولا يعني اسم M3 هنا أن معيد الترتيب يُرجع التضمينات الكثيفة والمتناثرة ومتعددة المتجهات الخاصة بنموذج التضمين الأصلي.</p><p>يهم هذا الفرق عند اختيار النتيجة التي يحتاجها تطبيقك. اختر نموذج تضمين لتمثيل مجموعة مستندات والبحث فيها. واختر معيد الترتيب هذا عندما يكون لديك نصوص مرشّحة وتحتاج إلى تحديد المقطع الأكثر صلة بالاستعلام الحالي.</p><h4>إعداد مرشحين يمكن ترتيبهم بصورة مفيدة</h4><p>قدّم السؤال الفعلي والنص الكامل للمرشّح اللازم لتفسيره. احتفظ بالعناوين أو التعريفات القريبة حين تحدّد معنى المقطع. في مثال Transformers المنشور، يُحوَّل الاستعلام والمقطع معًا إلى رموز مع الاقتطاع وmax_length=512. هذا إعداد للمثال وليس حدًا عامًا للنموذج. أبقِ السؤال والأدلة المطلوبة ضمن الميزانية المختارة للزوج، وتحقّق مما يزيله الاقتطاع. قد تذكر نتيجة المنتج نفسه الوارد في الاستعلام وتظل غير ذات صلة إذا تناولت عملية أو شرطًا غير المطلوب؛ جهّز أمثلة تميّز هذه الحالات عند تقييم جودة الاسترجاع.</p><p>في مساعد للمستندات، احتفظ بمعرّفات المرشحين إلى جانب نصوصهم، وقيّم أزواج السؤال والمقطع، ثم مرّر المقاطع الأصلية المختارة إلى خطوة الإجابة. يتلقى نموذج الإجابة حينئذ الأدلة بدل درجة صلة بلا مصدر. هذا مثال توضيحي لمسار استرجاع؛ أما معيد الترتيب نفسه فلا يبحث في مجموعة خارجية ولا يكتب الإجابة.</p><h4>قراءة الدرجات وتطبيعها</h4><p>تُرجع الشركة درجات صلة خامًا، وتشير القيمة الأعلى إلى تطابق أقرب. ويطبّق التطبيع الاختياري الموثّق دالة سيغمويد لجعل الدرجة بين 0 و1. يوفّر التطبيع نطاقًا ملائمًا، لكن هذا التحويل وحده لا يثبت احتمالًا معايرًا لصحة المرشّح.</p><p>اختر عتبات الترتيب أو التصفية باستخدام أزواج استعلام ومقطع ممثّلة لأعباء عملك. أدرج مقاطع تشترك في الكلمات المفتاحية لكنها تجيب عن سؤال مختلف، وكذلك مقاطع ذات صلة تستخدم صياغة مختلفة. يمنح ذلك العتبة المختارة معنىً للمجموعة التي يجري البحث فيها.</p><p>في مشروع يستخدم Ailoot API، حدّد ما ينبغي أن يتضمنه السياق النهائي وعدد المرشحين الذين يمكن فحصهم بكفاءة. النتيجة المفيدة مجموعة أدلة أفضل ترتيبًا لخطوة التطبيق التالية. افصل مخرجات الصلة في هذا الإصدار عن تضمينات المستندات والنصوص المولّدة وعناصر التحكم في اختيار الطبقات الموثّقة لمعِيدات ترتيب أخرى.</p></div></details></section><section class=\"card-section\" data-card-section=\"methods\"><h3 tabindex=\"-1\">متاح في Ailoot · المدخلات والطرائق</h3><details class=\"card-method\" open><summary><b>Ailoot Ultra · إعادة الترتيب</b> <code>POST /v1/rerank</code></summary><dl class=\"method-capabilities\"><div><dt>الإدخال</dt><dd><code>text</code></dd></div><div><dt>الإخراج</dt><dd><code>rerank</code></dd></div></dl><div class=\"tw\" data-card-parameters data-typed-parameters><table><thead><tr><th>الحقل</th><th>النوع</th><th>المتطلب</th><th>القيم والحدود</th><th>القيمة الافتراضية</th></tr></thead><tbody><tr><th data-cell-label=\"الحقل\" scope=\"row\"><span class=\"card-cell-label\">الحقل</span><code class=\"card-field-name\">model</code></th><td data-cell-label=\"النوع\" data-field-type><span class=\"card-cell-label\">النوع</span><code>string</code></td><td data-cell-label=\"المتطلب\"><span class=\"card-cell-label\">المتطلب</span>مطلوب</td><td data-cell-label=\"القيم والحدود\"><span class=\"card-cell-label\">القيم والحدود</span><div>bge-reranker-v2-m3</div></td><td data-cell-label=\"القيمة الافتراضية\" data-default=\"unspecified\"><span class=\"card-cell-label\">القيمة الافتراضية</span>—</td></tr><tr><th data-cell-label=\"الحقل\" scope=\"row\"><span class=\"card-cell-label\">الحقل</span><code class=\"card-field-name\">query</code></th><td data-cell-label=\"النوع\" data-field-type><span class=\"card-cell-label\">النوع</span><code>string</code></td><td data-cell-label=\"المتطلب\"><span class=\"card-cell-label\">المتطلب</span>اختياري</td><td data-cell-label=\"القيم والحدود\"><span class=\"card-cell-label\">القيم والحدود</span></td><td data-cell-label=\"القيمة الافتراضية\" data-default=\"unspecified\"><span class=\"card-cell-label\">القيمة الافتراضية</span>—</td></tr><tr><th data-cell-label=\"الحقل\" scope=\"row\"><span class=\"card-cell-label\">الحقل</span><code class=\"card-field-name\">documents</code></th><td data-cell-label=\"النوع\" data-field-type><span class=\"card-cell-label\">النوع</span><code>array</code></td><td data-cell-label=\"المتطلب\"><span class=\"card-cell-label\">المتطلب</span>مطلوب</td><td data-cell-label=\"القيم والحدود\"><span class=\"card-cell-label\">القيم والحدود</span></td><td data-cell-label=\"القيمة الافتراضية\" data-default=\"unspecified\"><span class=\"card-cell-label\">القيمة الافتراضية</span>—</td></tr></tbody></table></div><details class=\"note-s\" data-method-contract><summary>معلمات الطريقة ودورة حياتها</summary><div class=\"tw\" data-card-table=\"contract\"><table><thead><tr><th>المعلمة</th><th>المواصفات</th></tr></thead><tbody><tr><th data-cell-label=\"المعلمة\" scope=\"row\"><span class=\"card-cell-label\">المعلمة</span><code>content_type</code></th><td data-cell-label=\"المواصفات\"><span class=\"card-cell-label\">المواصفات</span>application/json</td></tr><tr><th data-cell-label=\"المعلمة\" scope=\"row\"><span class=\"card-cell-label\">المعلمة</span><code>required</code></th><td data-cell-label=\"المواصفات\"><span class=\"card-cell-label\">المواصفات</span>model, documents</td></tr><tr><th data-cell-label=\"المعلمة\" scope=\"row\"><span class=\"card-cell-label\">المعلمة</span><code>material_types</code></th><td data-cell-label=\"المواصفات\"><span class=\"card-cell-label\">المواصفات</span>text</td></tr><tr><th data-cell-label=\"المعلمة\" scope=\"row\"><span class=\"card-cell-label\">المعلمة</span><code>material_conditions</code></th><td data-cell-label=\"المواصفات\"><span class=\"card-cell-label\">المواصفات</span>حدّد استعلامك الفعلي ومصفوفة غير فارغة من المستندات النصية الأصلية. تشير فهارس النتائج إلى تلك المصفوفة الأصلية.</td></tr></tbody></table></div><p>دورة الحياة: <code>synchronous_result_then_owned_library</code></p><p class=\"note-s\"><code>GET /v1/media/assets/{asset_id}/content</code></p><p class=\"note-s\"><code>GET /v1/media/assets</code></p><p class=\"note-s\"><code>GET /v1/media/assets/{asset_id}</code></p></details></details></section><section class=\"card-section\" data-card-section=\"pricing\"><h3 tabindex=\"-1\">الباقات</h3><div data-native-semantic-method=\"v1\" data-tariff-reference-only><p class=\"note-s\" data-rate-support-note>مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.</p><dl data-price-conditions><dt>الوضع السريع</dt><dd>غير محدد <span class=\"note-s\">عند اختيار الوضع السريع</span></dd><dt>الوضع المرن</dt><dd>غير محدد <span class=\"note-s\">عند اختيار وضع flex</span></dd><dt>أقصى جهد للاستدلال</dt><dd>غير محدد <span class=\"note-s\">عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال</span></dd></dl></div><div data-declared-tariff-pricing><h4>تعرفات Ailoot</h4><h4>الأسعار حسب الإعدادات</h4><p class=\"note-s\">طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.</p><div class=\"tw\" data-pricing-profiles><table><thead><tr><th>الإعدادات</th><th>جدول التعرفة</th><th>وحدة الفوترة</th><th>الرسوم</th></tr></thead><tbody><tr><th data-cell-label=\"الإعدادات\" scope=\"row\"><span class=\"card-cell-label\">الإعدادات</span>التعرفات الأساسية للرموز</th><td data-cell-label=\"جدول التعرفة\"><span class=\"card-cell-label\">جدول التعرفة</span>التعرفة الأساسية</td><td data-cell-label=\"وحدة الفوترة\"><span class=\"card-cell-label\">وحدة الفوترة</span>—</td><td data-cell-label=\"الرسوم\"><span class=\"card-cell-label\">الرسوم</span><div><span>الإدخال · رموز الإدخال</span> <b>—</b> <span class=\"price-unit\">/ 1K من الرموز</span></div><div><span>الإخراج · رموز الإخراج</span> <b>—</b> <span class=\"price-unit\">/ 1K من الرموز</span></div><div><span>الإدخال · قراءة ذاكرة التخزين المؤقت</span> <b>—</b> <span class=\"price-unit\">/ 1K من الرموز</span></div><div><span>الإدخال · الكتابة إلى ذاكرة التخزين المؤقت</span> <b>—</b> <span class=\"price-unit\">/ 1K من الرموز</span></div><div><span>الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة</span> <b>—</b> <span class=\"price-unit\">/ 1K من الرموز</span></div></td></tr><tr><th data-cell-label=\"الإعدادات\" scope=\"row\"><span class=\"card-cell-label\">الإعدادات</span>رمز إجمالي</th><td data-cell-label=\"جدول التعرفة\"><span class=\"card-cell-label\">جدول التعرفة</span>—</td><td data-cell-label=\"وحدة الفوترة\"><span class=\"card-cell-label\">وحدة الفوترة</span>/ 1K من الرموز</td><td data-cell-label=\"الرسوم\"><span class=\"card-cell-label\">الرسوم</span><div><span>الإدخال · رمز إجمالي</span> <b>$0.00004</b> <span class=\"price-unit\">/ 1K من الرموز</span></div></td></tr></tbody></table></div></div><p class=\"note-s\">تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. <a href=\"/docs/ar/billing/reserve/\">كيفية عمل حجز المبلغ وتسوية الرسوم →</a></p></section><section class=\"card-section\" data-card-section=\"examples\"><h3 tabindex=\"-1\">أمثلة للطلبات</h3><h4>Ailoot Ultra · إعادة الترتيب</h4><div class=\"code-group\"><div class=\"cg-bar\"><div class=\"cg-tabs\" role=\"tablist\" aria-label=\"خيارات الشيفرة\"><button class=\"cg-tab\" id=\"model-code-1089-tab-0\" role=\"tab\" type=\"button\" aria-controls=\"model-code-1089-panel-0\" aria-selected=\"true\" tabindex=\"0\">استخدم المدخلات الفعلية واحتفظ بالنتيجة كاملة</button></div><div class=\"cg-tools\"><button class=\"cg-btn cg-copy\" type=\"button\" aria-label=\"نسخ الشيفرة\"><svg class=\"cp\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\"><rect x=\"5.25\" y=\"5.25\" width=\"8.5\" height=\"8.5\" rx=\"1.75\"/><path d=\"M10.75 5.25V3.5a1.25 1.25 0 0 0-1.25-1.25H3.5A1.25 1.25 0 0 0 2.25 3.5v6a1.25 1.25 0 0 0 1.25 1.25h1.75\"/></svg><svg class=\"ok\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\"><path d=\"m3 8.5 3.25 3.25L13 5\"/></svg></button></div></div><div class=\"cg-body\"><div class=\"cg-pane\" id=\"model-code-1089-panel-0\" role=\"tabpanel\" aria-labelledby=\"model-code-1089-tab-0\"><pre data-lang=\"bash\"><code>set -eu\n: &quot;${AILOOT_API_KEY:?Set your Ailoot API key}&quot;\n: &quot;${AILOOT_QUERY:?Set the actual documented input value}&quot;\nexport AILOOT_QUERY\n: &quot;${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}&quot;\nexport AILOOT_DOCUMENTS_JSON\npython3 - &lt;&lt;&#39;PY_REQUEST&#39;\nimport json,os\nfrom pathlib import Path\nrequest={&#39;model&#39;: &#39;bge-reranker-v2-m3&#39;, &#39;query&#39;: &#39;${ACTUAL_QUERY}&#39;, &#39;documents&#39;: &#39;${ACTUAL_DOCUMENTS}&#39;}\nrequest[&#39;query&#39;]=os.environ[&#39;AILOOT_QUERY&#39;]\nrequest[&#39;documents&#39;]=json.loads(os.environ[&#39;AILOOT_DOCUMENTS_JSON&#39;])\nPath(&#39;request.json&#39;).write_text(json.dumps(request,ensure_ascii=False),encoding=&#39;utf-8&#39;)\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \\\n  -H &quot;Authorization: Bearer $AILOOT_API_KEY&quot; -H &#39;Content-Type: application/json&#39; \\\n  --data-binary @request.json -D response-headers.txt -o response.bin\n# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.\n</code></pre></div></div></div></section><section class=\"card-section\" data-card-section=\"results\"><h3 tabindex=\"-1\">استلام النتائج وحفظها</h3><h4>Ailoot Ultra · إعادة الترتيب</h4><p class=\"note-s\">نتيجة JSON الأصلية كاملة بصيغتها الأصلية، مع نموذج الاستجابة المهيّأ، وفهارس المستندات الأصلية، ودرجات الصلة، والسلاسل النصية للمستندات، واستخدام التوكنات الأصلي. احتفظ بكل حقل نتيجة واستخدام فعلي.</p><ul class=\"card-result-paths\"><li><code>GET /v1/media/assets/{asset_id}/content</code></li><li><code>GET /v1/media/assets</code></li><li><code>GET /v1/media/assets/{asset_id}</code></li></ul><div class=\"card-result-process\" data-all-results><h5>الاحتفاظ بكل النتائج المكتملة</h5><p class=\"note-s\">احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.</p><p class=\"note-s\">احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.</p></div><div class=\"card-result-process\" data-unknown-recovery><h5>عند الحاجة إلى التحقق من الاستجابة الأصلية</h5><p class=\"note-s\">احتفظ بقيمة X-Client-Request-ID الفعلية وبالاستجابة كاملة. اقرأ الأصول الأصلية المملوكة لك وعناوين URL الدقيقة الموقّعة لمحتواها؛ ولا تعِد إرسال طلب إنشاء غير مؤكد النتيجة مطلقاً.</p></div><details class=\"card-about\" data-output-fields><summary>حقول الاستجابة</summary><div class=\"tw\" data-card-table=\"output\"><table><thead><tr><th>الحقل</th><th>النوع</th><th>المعنى</th></tr></thead><tbody><tr><th data-cell-label=\"الحقل\" scope=\"row\"><span class=\"card-cell-label\">الحقل</span><code class=\"card-field-name\">model</code></th><td data-cell-label=\"النوع\" data-field-type><span class=\"card-cell-label\">النوع</span>string</td><td data-cell-label=\"المعنى\"><span class=\"card-cell-label\">المعنى</span>نموذج الاستجابة الدقيق الذي يتطلبه مستهلك Source المهيّأ.</td></tr><tr><th data-cell-label=\"الحقل\" scope=\"row\"><span class=\"card-cell-label\">الحقل</span><code class=\"card-field-name\">results[].index</code></th><td data-cell-label=\"النوع\" data-field-type><span class=\"card-cell-label\">النوع</span>integer</td><td data-cell-label=\"المعنى\"><span class=\"card-cell-label\">المعنى</span>الفهرس الفريد لمستند الإدخال الأصلي.</td></tr><tr><th data-cell-label=\"الحقل\" scope=\"row\"><span class=\"card-cell-label\">الحقل</span><code class=\"card-field-name\">results[].relevance_score</code></th><td data-cell-label=\"النوع\" data-field-type><span class=\"card-cell-label\">النوع</span>number</td><td data-cell-label=\"المعنى\"><span class=\"card-cell-label\">المعنى</span>درجة صلة ذات قيمة منتهية.</td></tr><tr><th data-cell-label=\"الحقل\" scope=\"row\"><span class=\"card-cell-label\">الحقل</span><code class=\"card-field-name\">results[].document</code></th><td data-cell-label=\"النوع\" data-field-type><span class=\"card-cell-label\">النوع</span>string</td><td data-cell-label=\"المعنى\"><span class=\"card-cell-label\">المعنى</span>المستند النصي الأصلي الذي يتطلبه مستهلك الاستجابة المهيّأ هذا.</td></tr><tr><th data-cell-label=\"الحقل\" scope=\"row\"><span class=\"card-cell-label\">الحقل</span><code class=\"card-field-name\">usage.total_tokens</code></th><td data-cell-label=\"النوع\" data-field-type><span class=\"card-cell-label\">النوع</span>integer</td><td data-cell-label=\"المعنى\"><span class=\"card-cell-label\">المعنى</span>عدد توكنات أصلي ذو قيمة منتهية وغير سالبة، تتطلبه التعرفة المقبولة الحالية.</td></tr></tbody></table></div></details><details class=\"card-about\" data-method-errors><summary>الأخطاء والخطوات التالية</summary><div class=\"tw\" data-card-table=\"errors\"><table><thead><tr><th>الاستجابة</th><th>الشرط</th><th>الخطوة التالية</th></tr></thead><tbody><tr><th data-cell-label=\"الاستجابة\" scope=\"row\"><span class=\"card-cell-label\">الاستجابة</span>⁦400⁩ · <code>invalid_request_error</code></th><td data-cell-label=\"الشرط\"><span class=\"card-cell-label\">الشرط</span>متن JSON أو معرّف النموذج المعتمد الصريح غير صالح.</td><td data-cell-label=\"الخطوة التالية\"><span class=\"card-cell-label\">الخطوة التالية</span>احتفظ بالاستجابة وصحّح حقل الطلب المشار إليه.</td></tr><tr><th data-cell-label=\"الاستجابة\" scope=\"row\"><span class=\"card-cell-label\">الاستجابة</span>⁦401⁩ · <code>authentication_error</code></th><td data-cell-label=\"الشرط\"><span class=\"card-cell-label\">الشرط</span>مفتاح API الخاص بـAiloot غير صالح.</td><td data-cell-label=\"الخطوة التالية\"><span class=\"card-cell-label\">الخطوة التالية</span>استخدم مفتاح API المخوَّل لك في Ailoot.</td></tr><tr><th data-cell-label=\"الاستجابة\" scope=\"row\"><span class=\"card-cell-label\">الاستجابة</span>⁦403⁩ · <code>permission_error</code></th><td data-cell-label=\"الشرط\"><span class=\"card-cell-label\">الشرط</span>مجموعة المفتاح غير مخوّلة لاستخدام هذه الطريقة.</td><td data-cell-label=\"الخطوة التالية\"><span class=\"card-cell-label\">الخطوة التالية</span>احتفظ بتفاصيل الخطأ المُعادة.</td></tr><tr><th data-cell-label=\"الاستجابة\" scope=\"row\"><span class=\"card-cell-label\">الاستجابة</span>⁦404⁩ · <code>not_found_error</code></th><td data-cell-label=\"الشرط\"><span class=\"card-cell-label\">الشرط</span>لا يوجد مسار مسموح به للطريقة المختارة.</td><td data-cell-label=\"الخطوة التالية\"><span class=\"card-cell-label\">الخطوة التالية</span>احتفظ بتفاصيل الخطأ المُعادة.</td></tr><tr><th data-cell-label=\"الاستجابة\" scope=\"row\"><span class=\"card-cell-label\">الاستجابة</span>⁦422⁩ · <code>price_unavailable</code></th><td data-cell-label=\"الشرط\"><span class=\"card-cell-label\">الشرط</span>يتعذر على التعرفة المقبولة الحصول على كمية الإدخال المطلوبة أو حدّها.</td><td data-cell-label=\"الخطوة التالية\"><span class=\"card-cell-label\">الخطوة التالية</span>احتفظ بالاستجابة؛ واستخدم صيغة تمثيل الإدخال التي تتطلبها التعرفة المقبولة.</td></tr><tr><th data-cell-label=\"الاستجابة\" scope=\"row\"><span class=\"card-cell-label\">الاستجابة</span>⁦503⁩ · <code></code></th><td data-cell-label=\"الشرط\"><span class=\"card-cell-label\">الشرط</span>التخزين المطلوب أو المسار أو سعر الطريقة أو حجز الرصيد غير متاح.</td><td data-cell-label=\"الخطوة التالية\"><span class=\"card-cell-label\">الخطوة التالية</span>احتفظ بالاستجابة الأصلية كاملة. حجز الرصيد غير المؤكد لا يمنح الإذن بإعادة الإرسال.</td></tr><tr><th data-cell-label=\"الاستجابة\" scope=\"row\"><span class=\"card-cell-label\">الاستجابة</span>⁦502⁩ · <code>billing_requires_check</code></th><td data-cell-label=\"الشرط\"><span class=\"card-cell-label\">الشرط</span>تتطلب النتيجة الأصلية أو الاستخدام أو التسوية التحقق.</td><td data-cell-label=\"الخطوة التالية\"><span class=\"card-cell-label\">الخطوة التالية</span>احتفظ بمعرّف الطلب الفعلي وبالاستجابة الأصلية. اقرأ السجل الموجود المملوك لك؛ ولا تعِد إرسال طلب الإنشاء.</td></tr></tbody></table></div></details></section><section class=\"card-section\" data-card-section=\"aliases\"><h3 tabindex=\"-1\">الأسماء البديلة</h3><h4>الأسماء البديلة للنموذج</h4><p class=\"note-s\"><span data-model-alias-route=\"Ultra\"><b>Ailoot Ultra</b> <a href=\"#m=bge-reranker-v2-m3&amp;route=Ultra&amp;caller=bge-reranker-v2-m3&amp;fmt=rerank\"><code>bge-reranker-v2-m3</code></a></span></p><h4>الأسماء البديلة لمسارات الطرائق</h4><p class=\"note-s\">استخدم مسارات الطرائق المعروضة أعلاه.</p><h4>معرّفات النماذج ذات الصلة IDs</h4><p class=\"note-s\"><a href=\"#m=bge-reranker-v2-m3&amp;route=Ultra&amp;caller=bge-reranker-v2-m3&amp;fmt=rerank\"><code>bge-reranker-v2-m3</code></a></p></section></div>",
      "method_identity": {
        "effective_request_model_id": "bge-reranker-v2-m3",
        "fmt": "rerank",
        "http": "POST",
        "path": "/v1/rerank",
        "request_model_id": "bge-reranker-v2-m3",
        "route_label": "Ultra"
      },
      "method_key": "Ultra|rerank|/v1/rerank|bge-reranker-v2-m3",
      "ordinal": 0,
      "rawMethod": {
        "available": null,
        "cache_read": null,
        "cache_write": null,
        "cache_write_1h": null,
        "contract": {
          "data": {
            "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.",
            "errors": [
              {
                "code": null,
                "condition": "متن JSON أو معرّف النموذج المعتمد الصريح غير صالح.",
                "http_status": 400,
                "recovery": "احتفظ بالاستجابة وصحّح حقل الطلب المشار إليه.",
                "type": "invalid_request_error"
              },
              {
                "code": null,
                "condition": "مفتاح API الخاص بـAiloot غير صالح.",
                "http_status": 401,
                "recovery": "استخدم مفتاح API المخوَّل لك في Ailoot.",
                "type": "authentication_error"
              },
              {
                "code": null,
                "condition": "مجموعة المفتاح غير مخوّلة لاستخدام هذه الطريقة.",
                "http_status": 403,
                "recovery": "احتفظ بتفاصيل الخطأ المُعادة.",
                "type": "permission_error"
              },
              {
                "code": null,
                "condition": "لا يوجد مسار مسموح به للطريقة المختارة.",
                "http_status": 404,
                "recovery": "احتفظ بتفاصيل الخطأ المُعادة.",
                "type": "not_found_error"
              },
              {
                "code": null,
                "condition": "يتعذر على التعرفة المقبولة الحصول على كمية الإدخال المطلوبة أو حدّها.",
                "http_status": 422,
                "recovery": "احتفظ بالاستجابة؛ واستخدم صيغة تمثيل الإدخال التي تتطلبها التعرفة المقبولة.",
                "type": "price_unavailable"
              },
              {
                "code": null,
                "condition": "التخزين المطلوب أو المسار أو سعر الطريقة أو حجز الرصيد غير متاح.",
                "http_status": 503,
                "recovery": "احتفظ بالاستجابة الأصلية كاملة. حجز الرصيد غير المؤكد لا يمنح الإذن بإعادة الإرسال.",
                "type": null
              },
              {
                "code": null,
                "condition": "تتطلب النتيجة الأصلية أو الاستخدام أو التسوية التحقق.",
                "http_status": 502,
                "recovery": "احتفظ بمعرّف الطلب الفعلي وبالاستجابة الأصلية. اقرأ السجل الموجود المملوك لك؛ ولا تعِد إرسال طلب الإنشاء.",
                "type": "billing_requires_check"
              }
            ],
            "lifecycle": {
              "assets": [
                {
                  "http": "GET",
                  "path": "/v1/media/assets"
                },
                {
                  "http": "GET",
                  "path": "/v1/media/assets/{asset_id}"
                }
              ],
              "content": [
                {
                  "http": "GET",
                  "path": "/v1/media/assets/{asset_id}/content",
                  "url_source": "exact returned signed content URL"
                }
              ],
              "dedicated_method_polling_or_cancel": false,
              "mode": "synchronous_result_then_owned_library",
              "original_POST_adds_task_envelope": false,
              "status": [],
              "unknown": "احتفظ بقيمة X-Client-Request-ID الفعلية وبالاستجابة كاملة. اقرأ الأصول الأصلية المملوكة لك وعناوين URL الدقيقة الموقّعة لمحتواها؛ ولا تعِد إرسال طلب إنشاء غير مؤكد النتيجة مطلقاً."
            },
            "outputs": {
              "all_results": "احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.",
              "family": "rerank",
              "fields": [
                {
                  "description": "نموذج الاستجابة الدقيق الذي يتطلبه مستهلك Source المهيّأ.",
                  "name": "model",
                  "type": "string"
                },
                {
                  "description": "الفهرس الفريد لمستند الإدخال الأصلي.",
                  "name": "results[].index",
                  "type": "integer"
                },
                {
                  "description": "درجة صلة ذات قيمة منتهية.",
                  "name": "results[].relevance_score",
                  "type": "number"
                },
                {
                  "description": "المستند النصي الأصلي الذي يتطلبه مستهلك الاستجابة المهيّأ هذا.",
                  "name": "results[].document",
                  "type": "string"
                },
                {
                  "description": "عدد توكنات أصلي ذو قيمة منتهية وغير سالبة، تتطلبه التعرفة المقبولة الحالية.",
                  "name": "usage.total_tokens",
                  "type": "integer"
                }
              ],
              "result": "نتيجة JSON الأصلية كاملة بصيغتها الأصلية، مع نموذج الاستجابة المهيّأ، وفهارس المستندات الأصلية، ودرجات الصلة، والسلاسل النصية للمستندات، واستخدام التوكنات الأصلي. احتفظ بكل حقل نتيجة واستخدام فعلي."
            },
            "parameters": [
              {
                "default_known": false,
                "enum": [
                  "bge-reranker-v2-m3"
                ],
                "enum_known": true,
                "name": "model",
                "required": true,
                "type": "string"
              },
              {
                "default_known": false,
                "enum_known": false,
                "name": "query",
                "required": false,
                "type": "string"
              },
              {
                "default_known": false,
                "enum_known": false,
                "name": "documents",
                "required": true,
                "type": "array"
              }
            ],
            "request_schema": {
              "properties": {
                "documents": {
                  "items": {
                    "type": "string"
                  },
                  "minItems": 1,
                  "type": "array"
                },
                "model": {
                  "enum": [
                    "bge-reranker-v2-m3"
                  ],
                  "type": "string"
                },
                "query": {
                  "type": "string"
                }
              },
              "required": [
                "model",
                "documents"
              ],
              "type": "object"
            },
            "schema_template": {
              "actual_file_preparation_required": false,
              "body": {
                "documents": "${ACTUAL_DOCUMENTS}",
                "model": "bge-reranker-v2-m3",
                "query": "${ACTUAL_QUERY}"
              },
              "content_type": "application/json"
            }
          },
          "input": {
            "content_type": "application/json",
            "material_conditions": [
              "حدّد استعلامك الفعلي ومصفوفة غير فارغة من المستندات النصية الأصلية. تشير فهارس النتائج إلى تلك المصفوفة الأصلية."
            ],
            "material_types": [
              "text"
            ],
            "required": [
              "model",
              "documents"
            ]
          },
          "lifecycle": {
            "assets": [
              {
                "http": "GET",
                "path": "/v1/media/assets"
              },
              {
                "http": "GET",
                "path": "/v1/media/assets/{asset_id}"
              }
            ],
            "content": [
              {
                "http": "GET",
                "path": "/v1/media/assets/{asset_id}/content",
                "url_source": "exact returned signed content URL"
              }
            ],
            "dedicated_method_polling_or_cancel": false,
            "mode": "synchronous_result_then_owned_library",
            "original_POST_adds_task_envelope": false,
            "status": [],
            "unknown": "Retain the actual X-Client-Request-ID and complete response. Read the original owned assets and their exact signed content URLs; never resubmit an uncertain creation."
          },
          "method": {
            "http": "POST",
            "path": "/v1/rerank"
          },
          "output": {
            "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.",
            "family": "rerank",
            "fields": [
              {
                "description": "Exact response model required by the configured Source consumer.",
                "name": "model",
                "type": "string"
              },
              {
                "description": "Unique original input document index.",
                "name": "results[].index",
                "type": "integer"
              },
              {
                "description": "Finite relevance score.",
                "name": "results[].relevance_score",
                "type": "number"
              },
              {
                "description": "Original text document required by this configured response consumer.",
                "name": "results[].document",
                "type": "string"
              },
              {
                "description": "Finite nonnegative native token count required by the current accepted tariff.",
                "name": "usage.total_tokens",
                "type": "integer"
              }
            ],
            "result": "Complete original native JSON result with the configured response model, original document indices, relevance scores, document strings and native token usage. Retain every actual result and usage field."
          }
        },
        "ctx": null,
        "declared_pricing_profiles": [
          {
            "dimensions": {
              "regime": "base"
            },
            "label": "Base token rates",
            "units": [
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "input_price",
                "label": "Input tokens",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "input_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "input_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "output_price",
                "label": "Output tokens",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "output_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "out",
                "unit": "output_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_read_price",
                "label": "Cache read",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "cached_input_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "cached_input_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_write_price",
                "label": "Cache write",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "generic_cache_creation_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "generic_cache_creation_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_write_1h_price",
                "label": "Cache write, 1 hour",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "one_hour_cache_creation_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "one_hour_cache_creation_token"
              }
            ]
          },
          {
            "dimensions": {
              "quoted_unit": "/ 1K tokens"
            },
            "label": "total token",
            "units": [
              {
                "amount": "0.00004000",
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "total_token",
                "label": "total token",
                "native_amount_usd_per_unit": "0.00000004",
                "native_quantity": 1,
                "native_unit": "total_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "total_token"
              }
            ]
          }
        ],
        "examples": [
          {
            "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_QUERY:?Set the actual documented input value}\"\nexport AILOOT_QUERY\n: \"${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}\"\nexport AILOOT_DOCUMENTS_JSON\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nrequest={'model': 'bge-reranker-v2-m3', 'query': '${ACTUAL_QUERY}', 'documents': '${ACTUAL_DOCUMENTS}'}\nrequest['query']=os.environ['AILOOT_QUERY']\nrequest['documents']=json.loads(os.environ['AILOOT_DOCUMENTS_JSON'])\nPath('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \\\n  -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o response.bin\n# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.\n",
            "label": "Use actual input and retain the complete result",
            "language": "bash"
          }
        ],
        "family": "openai",
        "fast_multiplier": null,
        "flex_multiplier": null,
        "fmt": "rerank",
        "hints": [
          "Set your actual query and nonempty array of original text documents. Result indices refer to that original array.",
          "The minimum example omits top_n, return_documents, instruct and other optional controls.",
          "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again."
        ],
        "http": "POST",
        "in": null,
        "input": [
          "text"
        ],
        "label": "إعادة الترتيب",
        "max_out": null,
        "max_reasoning_effort_multiplier": null,
        "method_aliases": [],
        "native_endpoint": "rerank",
        "out": null,
        "output": [
          "rerank"
        ],
        "path": "/v1/rerank",
        "price_conditions": [
          {
            "label": "Fast mode",
            "value": "Not specified",
            "when": "When fast mode is selected"
          },
          {
            "label": "Flex mode",
            "value": "Not specified",
            "when": "When flex mode is selected"
          },
          {
            "label": "Maximum reasoning effort",
            "value": "Not specified",
            "when": "When maximum reasoning effort uses the default adjustment"
          }
        ],
        "pricing": {
          "billing_mode": "per_request",
          "image_input_price": null,
          "image_output_price": null,
          "per_request_price": null,
          "unit_prices": {
            "total_token": 4e-08
          }
        },
        "pricing_profiles": [
          {
            "dimensions": {
              "regime": "base"
            },
            "label": "Base token rates",
            "units": [
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "input_price",
                "label": "Input tokens",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "input_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "input_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "output_price",
                "label": "Output tokens",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "output_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "out",
                "unit": "output_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_read_price",
                "label": "Cache read",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "cached_input_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "cached_input_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_write_price",
                "label": "Cache write",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "generic_cache_creation_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "generic_cache_creation_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_write_1h_price",
                "label": "Cache write, 1 hour",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "one_hour_cache_creation_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "one_hour_cache_creation_token"
              }
            ]
          },
          {
            "dimensions": {
              "quoted_unit": "/ 1K tokens"
            },
            "label": "total token",
            "units": [
              {
                "amount": "0.00004000",
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "total_token",
                "label": "total token",
                "native_amount_usd_per_unit": "0.00000004",
                "native_quantity": 1,
                "native_unit": "total_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "total_token"
              }
            ]
          }
        ],
        "request_model_id": "bge-reranker-v2-m3",
        "route_label": "Ultra",
        "status_reads": [],
        "tiers": [],
        "units": [
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "input_price",
            "label": "Input tokens",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "input_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "input_token"
          },
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "output_price",
            "label": "Output tokens",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "output_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "out",
            "unit": "output_token"
          },
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "cache_read_price",
            "label": "Cache read",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "cached_input_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "cached_input_token"
          },
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "cache_write_price",
            "label": "Cache write",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "generic_cache_creation_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "generic_cache_creation_token"
          },
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "cache_write_1h_price",
            "label": "Cache write, 1 hour",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "one_hour_cache_creation_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "one_hour_cache_creation_token"
          },
          {
            "amount": "0.00004000",
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "total_token",
            "label": "total token",
            "native_amount_usd_per_unit": "0.00000004",
            "native_quantity": 1,
            "native_unit": "total_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "total_token"
          }
        ]
      }
    }
  ],
  "model_id": "bge-reranker-v2-m3",
  "nativeProvenance": {
    "input_facts_canonical_sha256": "28f535c96be876858963450d360eceeae6562d85d625ffd3905ac930e8defcf9",
    "input_html_sha256": "292f5ce32659361ee46c720fba6e2438a48045e043a529bb5c6a5b70df662d41",
    "private_audit_sha256": "49b032299485c0faef22812f129ab9ad97afa2eacaedbf3e2c31cf2ad8d88b95",
    "role": "historical-normalized-input-audit-hashes",
    "schema": "ailoot-native-model-provenance-v2"
  },
  "page": {
    "canonical": "https://ailoot.ai/models/ar/bge-reranker-v2-m3/",
    "description": "مُرمِّز تقاطعي متعدد اللغات من BAAI لترتيب المقاطع المرشحة مقابل استعلام. يقرأ كل زوج من الاستعلام والمقطع معًا ويعيد درجة صلة، لتنقيح قائمة البحث المختصرة من دون توليد إجابة أو إنشاء تضمينات للمستندات.",
    "locale": "ar",
    "md_url": "https://ailoot.ai/models/ar/bge-reranker-v2-m3/index.md",
    "title": "bge-reranker-v2-m3 — Ailoot",
    "url": "https://ailoot.ai/models/ar/bge-reranker-v2-m3/"
  },
  "rawModel": {
    "about": "BGE Reranker v2 M3 نموذج متعدد اللغات لتقدير الصلة، مبني على BGE-M3. يتلقى استعلامًا ومقطعًا مرشّحًا معًا ويُرجع درجة للعلاقة بينهما. تقدّم BAAI هذا الإصدار بوصفه نموذجًا كفؤًا متعدد اللغات لإعادة الترتيب، بما يشمل الاسترجاع بالصينية والإنجليزية حين يحتاج تطبيق البحث إلى تحسين قائمة مرشحين موجودة.\n\n### الصلة من زوج استعلام ومقطع\n\nيعالج المُرمِّز المتقاطع النصين معًا، مما يسمح بتفاعل محتواهما قبل إنتاج درجة الصلة. يختلف ذلك عن نموذج التضمين، الذي يرمّز النصوص بصورة مستقلة لمقارنة متجهات قابلة لإعادة الاستخدام. ناتج معيد الترتيب درجة عددية مفردة لزوج بعينه، وليس متجه مستند أو إجابة مكتوبة.\n\nاستخدم النموذج بعد أن يختار البحث الأولي مقاطع يُحتمل أن تكون مناسبة. اقرن السؤال بكل مرشّح ورتّب المرشحين وفق الدرجات الناتجة. يركّز ذلك المقارنة الأكثر تفصيلًا على قائمة مختصرة يسهل التعامل معها، بدل تكليف مُرمِّز متقاطع بفحص كل مقطع في مجموعة كبيرة.\n\n### إصدار v2 M3\n\nتحدّد الشركة BGE-M3 بوصفه النموذج الأساسي، وتذكر الدعم متعدد اللغات كميزة رئيسية. ضمن عائلة معيدات الترتيب v2، يُعد M3 الخيار الكفء متعدد اللغات؛ أما الإصدارات المبنية على Gemma وإصدارات اختيار الطبقات فهي نماذج مستقلة ذات خيارات تنفيذ مختلفة. ولا يعني اسم M3 هنا أن معيد الترتيب يُرجع التضمينات الكثيفة والمتناثرة ومتعددة المتجهات الخاصة بنموذج التضمين الأصلي.\n\nيهم هذا الفرق عند اختيار النتيجة التي يحتاجها تطبيقك. اختر نموذج تضمين لتمثيل مجموعة مستندات والبحث فيها. واختر معيد الترتيب هذا عندما يكون لديك نصوص مرشّحة وتحتاج إلى تحديد المقطع الأكثر صلة بالاستعلام الحالي.\n\n### إعداد مرشحين يمكن ترتيبهم بصورة مفيدة\n\nقدّم السؤال الفعلي والنص الكامل للمرشّح اللازم لتفسيره. احتفظ بالعناوين أو التعريفات القريبة حين تحدّد معنى المقطع. في مثال Transformers المنشور، يُحوَّل الاستعلام والمقطع معًا إلى رموز مع الاقتطاع وmax_length=512. هذا إعداد للمثال وليس حدًا عامًا للنموذج. أبقِ السؤال والأدلة المطلوبة ضمن الميزانية المختارة للزوج، وتحقّق مما يزيله الاقتطاع. قد تذكر نتيجة المنتج نفسه الوارد في الاستعلام وتظل غير ذات صلة إذا تناولت عملية أو شرطًا غير المطلوب؛ جهّز أمثلة تميّز هذه الحالات عند تقييم جودة الاسترجاع.\n\nفي مساعد للمستندات، احتفظ بمعرّفات المرشحين إلى جانب نصوصهم، وقيّم أزواج السؤال والمقطع، ثم مرّر المقاطع الأصلية المختارة إلى خطوة الإجابة. يتلقى نموذج الإجابة حينئذ الأدلة بدل درجة صلة بلا مصدر. هذا مثال توضيحي لمسار استرجاع؛ أما معيد الترتيب نفسه فلا يبحث في مجموعة خارجية ولا يكتب الإجابة.\n\n### قراءة الدرجات وتطبيعها\n\nتُرجع الشركة درجات صلة خامًا، وتشير القيمة الأعلى إلى تطابق أقرب. ويطبّق التطبيع الاختياري الموثّق دالة سيغمويد لجعل الدرجة بين 0 و1. يوفّر التطبيع نطاقًا ملائمًا، لكن هذا التحويل وحده لا يثبت احتمالًا معايرًا لصحة المرشّح.\n\nاختر عتبات الترتيب أو التصفية باستخدام أزواج استعلام ومقطع ممثّلة لأعباء عملك. أدرج مقاطع تشترك في الكلمات المفتاحية لكنها تجيب عن سؤال مختلف، وكذلك مقاطع ذات صلة تستخدم صياغة مختلفة. يمنح ذلك العتبة المختارة معنىً للمجموعة التي يجري البحث فيها.\n\nفي مشروع يستخدم Ailoot API، حدّد ما ينبغي أن يتضمنه السياق النهائي وعدد المرشحين الذين يمكن فحصهم بكفاءة. النتيجة المفيدة مجموعة أدلة أفضل ترتيبًا لخطوة التطبيق التالية. افصل مخرجات الصلة في هذا الإصدار عن تضمينات المستندات والنصوص المولّدة وعناصر التحكم في اختيار الطبقات الموثّقة لمعِيدات ترتيب أخرى.",
    "alias_of": null,
    "aliases": [],
    "author": "BAAI",
    "capabilities": {
      "context_length": 0,
      "manufacturer_input": [],
      "manufacturer_output": []
    },
    "card_routes": [
      {
        "label": "Ultra",
        "rates": [
          {
            "amount": "0.00004000",
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "total_token",
            "label": "total token",
            "native_amount_usd_per_unit": "0.00000004",
            "native_quantity": 1,
            "native_unit": "total_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "total_token"
          }
        ],
        "summary": "التسعير الكامل للتكوين في التفاصيل."
      }
    ],
    "ctx": null,
    "formats": [
      "rerank"
    ],
    "id": "bge-reranker-v2-m3",
    "input": [
      "text"
    ],
    "kind": "text",
    "max_out": null,
    "methods": [
      {
        "available": null,
        "cache_read": null,
        "cache_write": null,
        "cache_write_1h": null,
        "contract": {
          "data": {
            "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.",
            "errors": [
              {
                "code": null,
                "condition": "متن JSON أو معرّف النموذج المعتمد الصريح غير صالح.",
                "http_status": 400,
                "recovery": "احتفظ بالاستجابة وصحّح حقل الطلب المشار إليه.",
                "type": "invalid_request_error"
              },
              {
                "code": null,
                "condition": "مفتاح API الخاص بـAiloot غير صالح.",
                "http_status": 401,
                "recovery": "استخدم مفتاح API المخوَّل لك في Ailoot.",
                "type": "authentication_error"
              },
              {
                "code": null,
                "condition": "مجموعة المفتاح غير مخوّلة لاستخدام هذه الطريقة.",
                "http_status": 403,
                "recovery": "احتفظ بتفاصيل الخطأ المُعادة.",
                "type": "permission_error"
              },
              {
                "code": null,
                "condition": "لا يوجد مسار مسموح به للطريقة المختارة.",
                "http_status": 404,
                "recovery": "احتفظ بتفاصيل الخطأ المُعادة.",
                "type": "not_found_error"
              },
              {
                "code": null,
                "condition": "يتعذر على التعرفة المقبولة الحصول على كمية الإدخال المطلوبة أو حدّها.",
                "http_status": 422,
                "recovery": "احتفظ بالاستجابة؛ واستخدم صيغة تمثيل الإدخال التي تتطلبها التعرفة المقبولة.",
                "type": "price_unavailable"
              },
              {
                "code": null,
                "condition": "التخزين المطلوب أو المسار أو سعر الطريقة أو حجز الرصيد غير متاح.",
                "http_status": 503,
                "recovery": "احتفظ بالاستجابة الأصلية كاملة. حجز الرصيد غير المؤكد لا يمنح الإذن بإعادة الإرسال.",
                "type": null
              },
              {
                "code": null,
                "condition": "تتطلب النتيجة الأصلية أو الاستخدام أو التسوية التحقق.",
                "http_status": 502,
                "recovery": "احتفظ بمعرّف الطلب الفعلي وبالاستجابة الأصلية. اقرأ السجل الموجود المملوك لك؛ ولا تعِد إرسال طلب الإنشاء.",
                "type": "billing_requires_check"
              }
            ],
            "lifecycle": {
              "assets": [
                {
                  "http": "GET",
                  "path": "/v1/media/assets"
                },
                {
                  "http": "GET",
                  "path": "/v1/media/assets/{asset_id}"
                }
              ],
              "content": [
                {
                  "http": "GET",
                  "path": "/v1/media/assets/{asset_id}/content",
                  "url_source": "exact returned signed content URL"
                }
              ],
              "dedicated_method_polling_or_cancel": false,
              "mode": "synchronous_result_then_owned_library",
              "original_POST_adds_task_envelope": false,
              "status": [],
              "unknown": "احتفظ بقيمة X-Client-Request-ID الفعلية وبالاستجابة كاملة. اقرأ الأصول الأصلية المملوكة لك وعناوين URL الدقيقة الموقّعة لمحتواها؛ ولا تعِد إرسال طلب إنشاء غير مؤكد النتيجة مطلقاً."
            },
            "outputs": {
              "all_results": "احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.",
              "family": "rerank",
              "fields": [
                {
                  "description": "نموذج الاستجابة الدقيق الذي يتطلبه مستهلك Source المهيّأ.",
                  "name": "model",
                  "type": "string"
                },
                {
                  "description": "الفهرس الفريد لمستند الإدخال الأصلي.",
                  "name": "results[].index",
                  "type": "integer"
                },
                {
                  "description": "درجة صلة ذات قيمة منتهية.",
                  "name": "results[].relevance_score",
                  "type": "number"
                },
                {
                  "description": "المستند النصي الأصلي الذي يتطلبه مستهلك الاستجابة المهيّأ هذا.",
                  "name": "results[].document",
                  "type": "string"
                },
                {
                  "description": "عدد توكنات أصلي ذو قيمة منتهية وغير سالبة، تتطلبه التعرفة المقبولة الحالية.",
                  "name": "usage.total_tokens",
                  "type": "integer"
                }
              ],
              "result": "نتيجة JSON الأصلية كاملة بصيغتها الأصلية، مع نموذج الاستجابة المهيّأ، وفهارس المستندات الأصلية، ودرجات الصلة، والسلاسل النصية للمستندات، واستخدام التوكنات الأصلي. احتفظ بكل حقل نتيجة واستخدام فعلي."
            },
            "parameters": [
              {
                "default_known": false,
                "enum": [
                  "bge-reranker-v2-m3"
                ],
                "enum_known": true,
                "name": "model",
                "required": true,
                "type": "string"
              },
              {
                "default_known": false,
                "enum_known": false,
                "name": "query",
                "required": false,
                "type": "string"
              },
              {
                "default_known": false,
                "enum_known": false,
                "name": "documents",
                "required": true,
                "type": "array"
              }
            ],
            "request_schema": {
              "properties": {
                "documents": {
                  "items": {
                    "type": "string"
                  },
                  "minItems": 1,
                  "type": "array"
                },
                "model": {
                  "enum": [
                    "bge-reranker-v2-m3"
                  ],
                  "type": "string"
                },
                "query": {
                  "type": "string"
                }
              },
              "required": [
                "model",
                "documents"
              ],
              "type": "object"
            },
            "schema_template": {
              "actual_file_preparation_required": false,
              "body": {
                "documents": "${ACTUAL_DOCUMENTS}",
                "model": "bge-reranker-v2-m3",
                "query": "${ACTUAL_QUERY}"
              },
              "content_type": "application/json"
            }
          },
          "input": {
            "content_type": "application/json",
            "material_conditions": [
              "حدّد استعلامك الفعلي ومصفوفة غير فارغة من المستندات النصية الأصلية. تشير فهارس النتائج إلى تلك المصفوفة الأصلية."
            ],
            "material_types": [
              "text"
            ],
            "required": [
              "model",
              "documents"
            ]
          },
          "lifecycle": {
            "assets": [
              {
                "http": "GET",
                "path": "/v1/media/assets"
              },
              {
                "http": "GET",
                "path": "/v1/media/assets/{asset_id}"
              }
            ],
            "content": [
              {
                "http": "GET",
                "path": "/v1/media/assets/{asset_id}/content",
                "url_source": "exact returned signed content URL"
              }
            ],
            "dedicated_method_polling_or_cancel": false,
            "mode": "synchronous_result_then_owned_library",
            "original_POST_adds_task_envelope": false,
            "status": [],
            "unknown": "Retain the actual X-Client-Request-ID and complete response. Read the original owned assets and their exact signed content URLs; never resubmit an uncertain creation."
          },
          "method": {
            "http": "POST",
            "path": "/v1/rerank"
          },
          "output": {
            "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.",
            "family": "rerank",
            "fields": [
              {
                "description": "Exact response model required by the configured Source consumer.",
                "name": "model",
                "type": "string"
              },
              {
                "description": "Unique original input document index.",
                "name": "results[].index",
                "type": "integer"
              },
              {
                "description": "Finite relevance score.",
                "name": "results[].relevance_score",
                "type": "number"
              },
              {
                "description": "Original text document required by this configured response consumer.",
                "name": "results[].document",
                "type": "string"
              },
              {
                "description": "Finite nonnegative native token count required by the current accepted tariff.",
                "name": "usage.total_tokens",
                "type": "integer"
              }
            ],
            "result": "Complete original native JSON result with the configured response model, original document indices, relevance scores, document strings and native token usage. Retain every actual result and usage field."
          }
        },
        "ctx": null,
        "declared_pricing_profiles": [
          {
            "dimensions": {
              "regime": "base"
            },
            "label": "Base token rates",
            "units": [
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "input_price",
                "label": "Input tokens",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "input_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "input_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "output_price",
                "label": "Output tokens",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "output_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "out",
                "unit": "output_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_read_price",
                "label": "Cache read",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "cached_input_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "cached_input_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_write_price",
                "label": "Cache write",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "generic_cache_creation_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "generic_cache_creation_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_write_1h_price",
                "label": "Cache write, 1 hour",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "one_hour_cache_creation_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "one_hour_cache_creation_token"
              }
            ]
          },
          {
            "dimensions": {
              "quoted_unit": "/ 1K tokens"
            },
            "label": "total token",
            "units": [
              {
                "amount": "0.00004000",
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "total_token",
                "label": "total token",
                "native_amount_usd_per_unit": "0.00000004",
                "native_quantity": 1,
                "native_unit": "total_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "total_token"
              }
            ]
          }
        ],
        "examples": [
          {
            "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_QUERY:?Set the actual documented input value}\"\nexport AILOOT_QUERY\n: \"${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}\"\nexport AILOOT_DOCUMENTS_JSON\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nrequest={'model': 'bge-reranker-v2-m3', 'query': '${ACTUAL_QUERY}', 'documents': '${ACTUAL_DOCUMENTS}'}\nrequest['query']=os.environ['AILOOT_QUERY']\nrequest['documents']=json.loads(os.environ['AILOOT_DOCUMENTS_JSON'])\nPath('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \\\n  -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o response.bin\n# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.\n",
            "label": "Use actual input and retain the complete result",
            "language": "bash"
          }
        ],
        "family": "openai",
        "fast_multiplier": null,
        "flex_multiplier": null,
        "fmt": "rerank",
        "hints": [
          "Set your actual query and nonempty array of original text documents. Result indices refer to that original array.",
          "The minimum example omits top_n, return_documents, instruct and other optional controls.",
          "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again."
        ],
        "http": "POST",
        "in": null,
        "input": [
          "text"
        ],
        "label": "إعادة الترتيب",
        "max_out": null,
        "max_reasoning_effort_multiplier": null,
        "method_aliases": [],
        "native_endpoint": "rerank",
        "out": null,
        "output": [
          "rerank"
        ],
        "path": "/v1/rerank",
        "price_conditions": [
          {
            "label": "Fast mode",
            "value": "Not specified",
            "when": "When fast mode is selected"
          },
          {
            "label": "Flex mode",
            "value": "Not specified",
            "when": "When flex mode is selected"
          },
          {
            "label": "Maximum reasoning effort",
            "value": "Not specified",
            "when": "When maximum reasoning effort uses the default adjustment"
          }
        ],
        "pricing": {
          "billing_mode": "per_request",
          "image_input_price": null,
          "image_output_price": null,
          "per_request_price": null,
          "unit_prices": {
            "total_token": 4e-08
          }
        },
        "pricing_profiles": [
          {
            "dimensions": {
              "regime": "base"
            },
            "label": "Base token rates",
            "units": [
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "input_price",
                "label": "Input tokens",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "input_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "input_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "output_price",
                "label": "Output tokens",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "output_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "out",
                "unit": "output_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_read_price",
                "label": "Cache read",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "cached_input_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "cached_input_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_write_price",
                "label": "Cache write",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "generic_cache_creation_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "generic_cache_creation_token"
              },
              {
                "amount": null,
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "cache_write_1h_price",
                "label": "Cache write, 1 hour",
                "native_amount_usd_per_unit": null,
                "native_quantity": 1,
                "native_unit": "one_hour_cache_creation_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "one_hour_cache_creation_token"
              }
            ]
          },
          {
            "dimensions": {
              "quoted_unit": "/ 1K tokens"
            },
            "label": "total token",
            "units": [
              {
                "amount": "0.00004000",
                "amount_unit": "usd_per_thousand_tokens",
                "billing_input": true,
                "estimate_only": false,
                "key": "total_token",
                "label": "total token",
                "native_amount_usd_per_unit": "0.00000004",
                "native_quantity": 1,
                "native_unit": "total_token",
                "public_unit_label": "/ 1K tokens",
                "quantity": 1000,
                "quantity_is_estimate": false,
                "rate_role": "typed_native_retail_rate",
                "side": "in",
                "unit": "total_token"
              }
            ]
          }
        ],
        "request_model_id": "bge-reranker-v2-m3",
        "route_label": "Ultra",
        "status_reads": [],
        "tiers": [],
        "units": [
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "input_price",
            "label": "Input tokens",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "input_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "input_token"
          },
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "output_price",
            "label": "Output tokens",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "output_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "out",
            "unit": "output_token"
          },
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "cache_read_price",
            "label": "Cache read",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "cached_input_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "cached_input_token"
          },
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "cache_write_price",
            "label": "Cache write",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "generic_cache_creation_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "generic_cache_creation_token"
          },
          {
            "amount": null,
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "cache_write_1h_price",
            "label": "Cache write, 1 hour",
            "native_amount_usd_per_unit": null,
            "native_quantity": 1,
            "native_unit": "one_hour_cache_creation_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "one_hour_cache_creation_token"
          },
          {
            "amount": "0.00004000",
            "amount_unit": "usd_per_thousand_tokens",
            "billing_input": true,
            "estimate_only": false,
            "key": "total_token",
            "label": "total token",
            "native_amount_usd_per_unit": "0.00000004",
            "native_quantity": 1,
            "native_unit": "total_token",
            "public_unit_label": "/ 1K tokens",
            "quantity": 1000,
            "quantity_is_estimate": false,
            "rate_role": "typed_native_retail_rate",
            "side": "in",
            "unit": "total_token"
          }
        ]
      }
    ],
    "model_aliases": [
      {
        "canonical_model_id": "bge-reranker-v2-m3",
        "request_model_id": "bge-reranker-v2-m3",
        "route_label": "Ultra"
      }
    ],
    "name": "bge-reranker-v2-m3",
    "price": {
      "in": null,
      "in_label": null,
      "out": null,
      "out_label": null,
      "sort_in": null,
      "sort_out": null,
      "varies": true
    },
    "short": "مُرمِّز تقاطعي متعدد اللغات من BAAI لترتيب المقاطع المرشحة مقابل استعلام. يقرأ كل زوج من الاستعلام والمقطع معًا ويعيد درجة صلة، لتنقيح قائمة البحث المختصرة من دون توليد إجابة أو إنشاء تضمينات للمستندات."
  },
  "renderer_schema": {
    "method_order": "Original DTO methods order; every exact route/format/path/caller survives.",
    "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers."
  },
  "representation": "exact-public-dto-and-native-renderer-html",
  "representationNotes": {
    "current_reference": {
      "about_json_pointer": "/aboutHtml",
      "methods": [
        {
          "contract_json_pointer": "/methods/0/rawMethod/contract",
          "html_json_pointer": "/methods/0/html",
          "method_ordinal": 0
        }
      ],
      "role": "current-semantic-reference"
    },
    "raw_input": {
      "examples_role": "historical-input-not-current-ready-examples",
      "json_pointers": [
        "/rawModel",
        "/methods/0/rawMethod"
      ],
      "role": "historical-owner-input"
    },
    "schema": "ailoot-native-model-representations-v1"
  },
  "schema": "ailoot-static-model-facts-v1",
  "schema_version": 1,
  "shortText": "مُرمِّز تقاطعي متعدد اللغات من BAAI لترتيب المقاطع المرشحة مقابل استعلام. يقرأ كل زوج من الاستعلام والمقطع معًا ويعيد درجة صلة، لتنقيح قائمة البحث المختصرة من دون توليد إجابة أو إنشاء تضمينات للمستندات.",
  "source": {
    "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1",
    "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036",
    "raw_model_json_sha256": "313550a8c940211a8bca51a6a77e5d93b90040dfe5117d508048ccf141061e63",
    "renderer_sha256": "081ee0fd5b6b1b60564b02c52d62547e01e922c8c0a16e91a0d055073e76a10e"
  },
  "sourceRevision": "7ddaed874b16be296f13aa3fbf1abc9f92855cb16dd791bc08a4c0966560f06a"
}