Qwen3 Reranker 8B
Qwen3 Reranker 8B可依搜尋查詢對提供的文字文件排序。請將qwen/qwen3-reranker-8b、查詢與候選段落傳送至Rerank端點，再使用回傳的關聯分數與原始文件索引，選擇搜尋結果、知識庫回答或檢索工作流程所需資料。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
Qwen3 Reranker 8B是文字重排序模型，確切ID為qwen/qwen3-reranker-8b。它接收查詢與候選文件集合，並回傳關聯排序。實際應用位置可在初始搜尋與使用選定段落的應用程式之間：先檢索可能符合的項目，再依實際問題重新排序，並將選定來源文字傳至下一步。
請將含有model、query與documents的JSON主體傳送至POST /v1/rerank。將model設為qwen/qwen3-reranker-8b，以字串提供搜尋問題，並將候選段落放入非空文字字串陣列。請保留輸入陣列順序及您的文件識別碼，因為回傳的index是依文件原始位置識別。請在各候選項目的提供文字中，納入決定關聯性的資料，例如產品名稱、政策條件或技術段落。
選用的top_n參數為最小值1的整數，用來選擇回傳多少份最相關文件。客服搜尋的query可以是客戶的原始問題，documents則可以是候選說明中心章節。對於內部知識庫，請結合問題與段落，並在段落中保留章節標題及足夠前後文，以說明各個結果。請選擇符合下游回答或搜尋顯示需求的結果數量。
公開模型資料列出40,960個詞元的上下文長度。準備請求時，請將查詢與提供文件文字納入計算，並選擇有助於回答問題的段落。重排序會產生分數與來源選擇；若下一步需要撰寫回答或引文，請使用選定文件文字。
操作會回傳完整JSON回應。請依回傳關聯順序讀取results，保留各結果的index、relevance_score與回傳document內容，若回應中有model、識別碼與usage欄位，也請一併保留。呈現來源或組合回答前，請將索引對應回原始文件。若傳送中斷，請儲存原始回應與請求識別資訊，以便調查既有結果，避免再次提交同一個結果不確定的操作。
Ailoot Ultra · Rerank POST /v1/rerank qwen/qwen3-reranker-8b
qwen/qwen3-reranker-8b入門
Qwen3 Reranker 8B可依搜尋查詢對提供的文字文件排序。請將qwen/qwen3-reranker-8b、查詢與候選段落傳送至Rerank端點，再使用回傳的關聯分數與原始文件索引，選擇搜尋結果、知識庫回答或檢索工作流程所需資料。
- 接受的輸入
- 文字
- 結果
- ranking
Ailoot 可用 · 輸入與方法
Ailoot Ultra · Rerank POST /v1/rerank
- 輸入
text- 輸出
ranking- 輸出格式
- JSON
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 qwen/qwen3-reranker-8b | 預設值— |
欄位query | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位documents | 類型array | 要求必填 | 值與限制 | 預設值— |
欄位top_n | 類型integer | 要求選填 | 值與限制 最小值: 1 | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, query, documents |
參數optional | 規格top_n |
參數material_types | 規格text |
參數conditions | 規格 |
生命週期： synchronous_json
方案
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 未指定 選取快速模式時
- flex 模式
- 未指定 選取 flex 模式時
- 最高推理強度
- 未指定 最高推理強度採用 default 調整值時
Ailoot 費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 計費單位 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 計費單位— | 費用 輸入 · 輸入 Token — / 1K Token 輸出 · 輸出 Token — / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token |
| 設定輸入 token | 費率表— | 計費單位/ 1K Token | 費用 輸入 $0.0004 / 1K Token |
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · Rerank
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"documents": ["Paris is the capital of France.", "Berlin is the capital of Germany."], "model": "qwen/qwen3-reranker-8b", "query": "What is the capital of France?", "top_n": 3}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
接收並儲存結果
Ailoot Ultra · Rerank
JSON
保留所有已完成的結果
請保留所有完整傳回的回應、檔案與內容區塊。
Retain the complete response, all actual results, original identifiers, usage and response headers.
需要檢查原始回應時
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
回應欄位
| 欄位 | 類型 |
|---|---|
欄位results | 類型array |
別名
模型別名
Ailoot Ultra qwen/qwen3-reranker-8b
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Qwen3 Reranker 8B
- 可以使用哪些輸入與結果？
POST /v1/rerank·qwen/qwen3-reranker-8b:text→ranking- 請求使用哪些欄位？
POST /v1/rerank·qwen/qwen3-reranker-8b:model,query,documents,top_n- 適用哪些限制？
POST /v1/rerank·qwen/qwen3-reranker-8b:top_n.minimum:1