文档重排序（Rerank）

POST https://open.feiyutoken.com/v1/rerank

请求参数

参数	类型	必填	说明
model	string	是	重排序模型名。可用值见模型列表
query	string	是	查询文本，用来和文档逐条比对相关性
documents	array	是	要重排序的文档列表，元素可以是字符串，也可以是对象
top_n	integer	否	只返回分数最高的前 N 条；不传则返回全部
return_documents	boolean	否	true 时结果里带上文档内容；默认 false

其余标准参数按原样透传。

请求示例

curl https://open.feiyutoken.com/v1/rerank \
  -H "Authorization: Bearer <你的飞鱼Token API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "query": "什么是 API 网关",
    "documents": [
      "API 网关是统一接入模型服务的中间层。",
      "本文介绍如何配置本地开发环境。"
    ],
    "top_n": 2,
    "return_documents": true
  }'

响应

{
  "id": "<请求 ID>...",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.87,
      "document": { "text": "API 网关是统一接入模型服务的中间层。" }
    }
  ],
  "meta": {}
}

results 通常按 relevance_score 从高到低排列（以实际返回为准），index 是文档在请求 documents 里的下标 —— 拿它回去对应原文，不要按返回顺序猜。document 字段只在 return_documents 为 true 时出现， meta 是附加信息，具体字段以实际返回为准。