API 參考
Rerank
對候選文檔按查詢相關性重新排序。
Rerank 接口接收一個查詢和一組候選文檔，返回按相關性排序的結果，適合 RAG 檢索後重排。
端點
| 方法 | 路徑 | 說明 |
|---|---|---|
POST | /v1/rerank | 對候選文檔重排序 |
請求參數
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
model | string | 是 | Rerank 模型 ID |
query | string | 是 | 查詢文本 |
documents | array | 是 | 候選文檔數組，可為字符串或對象 |
top_n | integer | 否 | 返回前 N 個結果 |
return_documents | boolean | 否 | 是否在結果中返回原文檔，默認 false |
max_chunk_per_doc | integer | 否 | 單文檔最大分塊數，取決於渠道支持 |
overlap_tokens | integer | 否 | 分塊重疊 token 數，取決於渠道支持 |
curl 示例
curl https://api.tensoraxis.ai/v1/rerank \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TENSORAXIS_API_KEY" \
-d '{
"model": "jina-reranker-v2-base-multilingual",
"query": "什麼是 API 網關？",
"documents": [
"API 網關負責統一鑑權、路由和限流。",
"向量數據庫用於相似度檢索。",
"對象存儲用於保存文件。"
],
"top_n": 2,
"return_documents": true
}'響應結構
{
"results": [
{
"index": 0,
"relevance_score": 0.98,
"document": "API 網關負責統一鑑權、路由和限流。"
}
],
"usage": {
"total_tokens": 42
}
}如果 return_documents 為 false，結果中通常只返回 index 與 relevance_score。