重排序（Rerank）

对一组候选文档按与查询的相关性重新排序，常用于检索增强（RAG）中对召回结果做精排，以提升上下文质量。

创建重排序

POST /v1/rerank

请求参数

参数	类型	必填	说明
model	string	是	重排序模型标识
query	string	是	查询文本
documents	array	是	候选文档字符串数组
top_n	integer	否	返回相关性最高的前 N 条
return_documents	boolean	否	是否在结果中返回原文，默认 false

请求示例

curl https://ai.youqi.tech/v1/rerank \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rerank-multilingual",
    "query": "如何重置密码？",
    "documents": [
      "在登录页点击「忘记密码」并按提示操作。",
      "本平台支持多种大语言模型。",
      "账户余额可在控制台查看。"
    ],
    "top_n": 2,
    "return_documents": true
  }'

响应示例

{
  "object": "list",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.98,
      "document": { "text": "在登录页点击「忘记密码」并按提示操作。" }
    },
    {
      "index": 2,
      "relevance_score": 0.12,
      "document": { "text": "账户余额可在控制台查看。" }
    }
  ],
  "model": "rerank-multilingual",
  "usage": { "total_tokens": 64 }
}

响应字段

字段	类型	说明
results[].index	integer	对应输入 documents 中的原始索引
results[].relevance_score	number	相关性得分，越高越相关
results[].document	object	当 return_documents=true 时返回原文