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.com/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。