Qwen: Qwen3 Rerank
Qwen3 Rerank 依所提供的查詢和指示排列候選文字。確切的 qwen3-rerank 設定接受文字文件清單，並回傳帶索引的相關性分數與用量資訊，供檢索和文件篩選工作流程使用。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
Qwen3 Rerank 依所提供的查詢和排序指示評估候選文字。確切設定的選擇碼為 qwen3-rerank。它的用途是為檢索和文件篩選排列所提供的候選內容；請求將查詢、指示和候選段落一同保留，讓相關性判斷可追溯至其輸入。
請將 documents 準備為字串陣列，每個項目包含一段候選文字。另行保留陣列各位置與你自己的文件識別碼、標題或來源位置之間的對照。這讓應用程式能將排序結果重新連結至原始段落，而不必把未記載的識別碼物件加入字串陣列。針對支援搜尋，候選內容可來自已從產品指南擷取的相關章節；查詢應說明使用者實際的資訊需求。
文件中的請求要求提供 model、documents、query、top_n 和 instruct。query 和 instruct 欄位是字串，top_n 則是明確提供的整數。公布的範例使用三段候選文字、top_n=2，以及要求擷取能回答網頁搜尋查詢的相關段落之指示。請用 instruct 說明排序所重視的關係，同時將實際問題放在 query，待評估資料放在 documents。
操作指南列出最大輸入長度為 30K。請讓候選段落聚焦於判斷相關性所需的文字，並在標題或鄰近上下文會改變意思時保留它們。請保留來源界線，讓所選段落仍可在原始文件中查核。確切請求設定和必要欄位，仍是準備輸入的依據。
回傳的結構化結果含有帶 index 和 relevance_score 的 results 項目。index 指候選內容在原始 documents 陣列中的位置，而非它在排序結果清單中的位置。請保留回傳順序，並用每個 index 找回對應的輸入文字。請保留每項回傳結果，讓應用程式能一併檢查所選候選內容和其分數。
請保留完整 JSON 回應，包括 model、回應 id 和 usage.total_tokens。回傳結果可能沒有文件文字，因此處理索引時，請讓原始候選陣列仍可供使用。相關性分數與回報用量各有用途：分數描述排序結果，用量則記錄該操作回報的數量。兩者都不能取代後續答案所依據的原始段落。
針對檢索工作流程，請利用排序選出下一步應檢查或引用的段落。在將內容呈現為證據之前，請依查詢和指示比較所選段落。結果清單中的高排名，表示它是待審閱的候選內容；應用程式最後的答案，仍應連結至實際文字及其來源識別碼。
請用具代表性的查詢和應用程式使用的候選集合檢查結果。確認索引能對應至預期的原始文字、排序符合所提供的指示，以及所選段落能回應問題。請將確切選擇碼、查詢、指示、候選對照和完整回應一同保留，形成可供下一步檢索或文件處理重複使用的相關內容篩選紀錄。
Ailoot Ultra · 重新排序 POST /v1/rerank qwen3-rerank
qwen3-rerank入門
Qwen3 Rerank 依所提供的查詢和指示排列候選文字。確切的 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 費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 計費單位 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 計費單位— | 費用 輸入 · 輸入 Token — / 1K Token 輸出 · 輸出 Token — / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token |
| 設定總詞元 | 費率表— | 計費單位/ 1K Token | 費用 輸入 · 總詞元 $0.00014 / 1K Token |
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · 重新排序
{
"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 · 重新排序
請讀取索引與相關性分數，並依各索引對應回原始文件。回應可能不包含原文件的回傳副本。
需要檢查原始回應時
若傳送結果不明確，請保留原始回應與請求 id；切勿重送該請求。
回應欄位
| 欄位 | 類型 | 含義 |
|---|---|---|
欄位results[].index | 類型integer | 含義對應的原始輸入文件索引。 |
欄位results[].relevance_score | 類型number | 含義回傳的相關性分數。 |
欄位model | 類型string | 含義實際的回應模型。 |
欄位id | 類型string | 含義實際的回應識別碼。 |
欄位usage.total_tokens | 類型integer | 含義用於計費的實測詞元總數。 |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件JSON 或必要的模型選擇值無效。 | 下一步提出新的請求前，請先修正指出的輸入問題。 |
回應401 · authentication_error | 條件API 金鑰無效。 | 下一步請使用有效的 Ailoot API 金鑰。 |
回應503 · price_unavailable | 條件無法取得結構化方法定價，或未開放使用。 | 下一步請保留原始回應；切勿重送傳送結果不明的請求。 |
別名
模型別名
Ailoot Ultra qwen3-rerank
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Qwen: Qwen3 Rerank
- 可以使用哪些輸入與結果？
POST /v1/rerank·qwen3-rerank:text→structured- 請求使用哪些欄位？
POST /v1/rerank·qwen3-rerank:model,documents,query,top_n,instruct