Qwen: Qwen3 Rerank

Qwen3 Rerank מדרג טקסטים מועמדים לפי שאילתה והוראה שסופקו. הפרופיל המדויק qwen3-rerank מקבל רשימות מסמכי טקסט ומחזיר ציוני רלוונטיות עם אינדקסים ומטא־נתוני שימוש לתהליכי אחזור מידע ובחירת מסמכים.

Ailoot Ultra · דירוג מחדש POST /v1/rerank qwen3-rerank

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

Qwen3 Rerank מעריך טקסטים מועמדים מול שאילתה והוראת דירוג שסופקו. הבורר המדויק שהוגדר הוא qwen3-rerank. תפקידו לסדר את המועמדים שסופקו לצורכי אחזור מידע ובחירת מסמכים; הבקשה שומרת יחד את השאילתה, ההוראה והקטעים המועמדים, כדי שאפשר יהיה לקשר את הערכת הרלוונטיות בחזרה לקלטים שלה.

הכינו את המסמכים כמערך מחרוזות, עם קטע מועמד אחד בכל איבר. שמרו מיפוי נפרד מכל מיקום במערך למזהה המסמך, לכותרת או למיקום המקור שלכם. כך האפליקציה יכולה לקשר מחדש תוצאה מדורגת לקטע המקורי בלי להוסיף למערך המחרוזות אובייקטים של מזהים שאינם מתועדים. בחיפוש לצורכי תמיכה, המועמדים יכולים להיות הסעיפים הרלוונטיים שכבר אוחזרו ממדריך מוצר; השאילתה צריכה לציין את צורך המידע האמיתי של המשתמש.

הבקשה המתועדת מחייבת model, documents, query, top_n ו-instruct. השדות query ו-instruct הם מחרוזות, ו-top_n הוא מספר שלם שמסופק במפורש. הדוגמה שפורסמה משתמשת בשלושה טקסטים מועמדים, ב-top_n=2 ובהוראה לאחזר קטעים רלוונטיים שעונים על שאילתת חיפוש באינטרנט. השתמשו ב-instruct כדי לציין את הקשר שחשוב לדירוג, תוך שמירת השאלה בפועל ב-query והחומר להערכה ב-documents.

מדריך הפעולה מציין אורך קלט מרבי של 30K. השאירו את הקטעים המועמדים ממוקדים בטקסט הדרוש להערכת הרלוונטיות שלהם, תוך שמירה על כותרות או הקשר סמוך כשהם משנים את המשמעות. שמרו על גבולות המקורות כדי שקטע שנבחר עדיין יוכל להיבדק במסמך המקורי שלו. פרופיל הבקשה המדויק והשדות המחייבים שלו נשארים הבסיס להכנת הקלט.

התוצאה המובנית שהוחזרה מכילה רשומות results עם index ו-relevance_score. השדה index מתייחס למיקום המועמד במערך documents המקורי, ולא למיקומו ברשימת התוצאות המדורגת. שמרו על הסדר שהוחזר והשתמשו בכל index כדי לשחזר את טקסט הקלט המתאים. שמרו כל תוצאה שהוחזרה כדי שהאפליקציה תוכל לבדוק יחד את המועמדים שנבחרו ואת הציונים שלהם.

שמרו את תגובת ה-JSON המלאה, כולל model, מזהה התגובה id ו-usage.total_tokens. טקסט המסמך המוחזר יכול להיות חסר, ולכן יש לשמור את מערך המועמדים המקורי זמין בעת עיבוד האינדקסים. לציוני הרלוונטיות ולשימוש המדווח יש תפקידים נפרדים: הציונים מתארים את תוצאת הדירוג, והשימוש מתעד את הכמות שדווחה עבור הפעולה. אף אחד מהם אינו מחליף את קטע המקור שתומך בתשובה בהמשך.

לתהליך אחזור מידע, השתמשו בדירוג כדי לבחור את הקטעים שהשלב הבא צריך לבדוק או לצטט. השוו קטע שנבחר לשאילתה ולהוראה לפני הצגת תוכנו כראיה. מיקום גבוה ברשימת תוצאות מצביע על מועמד לבדיקה; התשובה הסופית של האפליקציה צריכה להישאר מחוברת לטקסט בפועל ולמזהה המקור שלו.

בדקו את התוצאה באמצעות שאילתות מייצגות וקבוצות המועמדים שהאפליקציה משתמשת בהן. ודאו שהאינדקסים מצביעים על הטקסטים המקוריים המיועדים, שהסדר משרת את ההוראה שסופקה ושהקטעים שנבחרו מתייחסים לשאלה. שמרו יחד את הבורר המדויק, השאילתה, ההוראה, מיפוי המועמדים והתגובה המלאה, וצרו רשומה ניתנת לשימוש חוזר של בחירה לפי רלוונטיות לשלב הבא באחזור המידע או בעבודה על המסמך.

Ailoot Ultra · דירוג מחדש POST /v1/rerank qwen3-rerank

qwen3-rerank

Qwen /qwen3-rerank

התחלה

סוגי קלט נתמכים: טקסט
תוצאות: structured

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · דירוג מחדש POST /v1/rerank

סוגי קלט: text
סוגי פלט: structured
פורמט פלט: application/json

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות qwen3-rerank תנאים: בורר המודלים בערכו המילולי.	ברירת מחדל—
שדה`documents`	סוג`array`	דרישהחובה	ערכים ומגבלות תנאים: קטעי טקסט מועמדים, הנשמרים בסדר הקלט המקורי שלהם.	ברירת מחדל—
שדה`query`	סוג`string`	דרישהחובה	ערכים ומגבלות תנאים: שאילתת רלוונטיות.	ברירת מחדל—
שדה`top_n`	סוג`integer`	דרישהחובה	ערכים ומגבלות תנאים: מספר התוצאות המדורגות המבוקש; אין כאן קביעה של מינימום, מקסימום או ברירת מחדל שאינם מתועדים.	ברירת מחדל—
שדה`instruct`	סוג`string`	דרישהחובה	ערכים ומגבלות תנאים: הוראה המתארת את משימת האחזור.	ברירת מחדל—

שילובים של חומרי קלט

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`content_type`	מפרטapplication/json
פרמטר`required`	מפרטmodel, documents, query, top_n, instruct
פרמטר`optional`	מפרט
פרמטר`material_types`	מפרטtext
פרמטר`additional_properties`	מפרטtrue

מחזור חיים: synchronous

תעריפים

מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.

מצב מהיר: לא צוין כאשר נבחר מצב מהיר
מצב Flex: לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי: לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

תעריפי Ailoot

מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

תצורה	טבלת תעריפים	יחידת חיוב	חיוב
תצורהתעריפי בסיס לטוקנים	טבלת תעריפיםתעריף בסיס	יחידת חיוב—	חיוב קלט · טוקני קלט — / 1K טוקנים פלט · טוקני פלט — / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים
תצורהסך הטוקנים	טבלת תעריפים—	יחידת חיוב/ 1K טוקנים	חיוב קלט · סך הטוקנים $0.00014 / 1K טוקנים

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →

דוגמאות לבקשות

Ailoot Ultra · דירוג מחדש

JSON · דרגו מחדש טקסט

{
  "model": "qwen3-rerank",
  "query": "Which passage discusses text ranking?",
  "documents": [
    "Text ranking orders candidate passages by relevance.",
    "Quantum computing studies computation using quantum systems.",
    "Pretrained language models can improve text ranking."
  ],
  "top_n": 2,
  "instruct": "Given a web search query, retrieve relevant passages that answer the query."
}

קבלה ושמירה של תוצאות

Ailoot Ultra · דירוג מחדש

יש לקרוא את האינדקסים ואת ציוני הרלוונטיות ולמפות כל אינדקס בחזרה למסמכים המקוריים שלכם. ייתכן שהמסמך לא יוחזר כהעתק.

כשצריך לבדוק את התגובה המקורית

יש לשמור את התגובה המקורית ואת מזהה הבקשה לאחר שליחה שתוצאתה אינה חד־משמעית; אין לשחזר את השליחה.

שדות התגובה

שדה	סוג	משמעות
שדה`results[].index`	סוגinteger	משמעותהאינדקס של מסמך הקלט המקורי המתאים.
שדה`results[].relevance_score`	סוגnumber	משמעותציון הרלוונטיות שהוחזר.
שדה`model`	סוגstring	משמעותהמודל בפועל בתגובה.
שדה`id`	סוגstring	משמעותמזהה התגובה בפועל.
שדה`usage.total_tokens`	סוגinteger	משמעותמספר הטוקנים הכולל שנמדד ומשמש לחיוב.

שגיאות והשלבים הבאים

תגובה	תנאי	השלב הבא
תגובה⁦400⁩ · `invalid_request_error`	תנאיJSON לא תקף או בחירת מודל נדרשת שאינה תקפה.	השלב הבאיש לתקן את הקלט שצוין לפני שליחת בקשה חדשה.
תגובה⁦401⁩ · `authentication_error`	תנאימפתח API לא תקין.	השלב הבאיש להשתמש במפתח ה־API התקף שלכם של Ailoot.
תגובה⁦503⁩ · `price_unavailable`	תנאיתמחור מובנה לשיטה או הרשאת גישה אינם זמינים.	השלב הבאיש לשמור את התגובה המקורית; אין לשלוח שוב בקשה שתוצאת שליחתה אינה חד־משמעית.

כינויים

כינויים למודל

Ailoot Ultra qwen3-rerank

כינויים לנתיבי שיטות

השתמשו בנתיבי השיטות המוצגים למעלה.

מזהי מודלים קשורים IDs

qwen3-rerank

FAQ · Qwen: Qwen3 Rerank

אילו קלטים ותוצאות זמינים?: POST /v1/rerank · qwen3-rerank: text → structured
באילו שדות הבקשה משתמשת?: POST /v1/rerank · qwen3-rerank: model, documents, query, top_n, instruct

Qwen: Qwen3 Rerank