首页 › API 文档 › AI 能力

文档重排序

根据查询文本对一组文档按相关性重新排序,适用于RAG检索中的候选文档排序,优化检索结果的相关性

接口地址

POST https://api.tinyaii.cn/v1/rerank

分类:AI 能力 · 返回格式:JSON · 鉴权:API Key(URL 参数 apikey 或请求头 Authorization: Bearer)

请求参数

参数名类型必填说明
querystring是查询文本,用于和文档做相关性比对
documentsarray是待排序的文档列表,字符串数组(最多50条)
top_ninteger否返回最相关的文档数量,默认返回全部

返回字段

字段名类型说明
querystring原始查询文本
resultsarray排序结果数组,按相关性从高到低排列
results[].indexinteger原文档在输入数组中的索引位置
results[].documentstring原文档文本内容
results[].relevance_scorefloat相关性得分,范围 0-1,越高越相关

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "query": "什么是机器学习",
    "results": [
      {
        "index": 0,
        "document": {
          "text": "机器学习是人工智能的一个分支,通过数据训练模型来自动改进算法性能。"
        },
        "relevance_score": 0.95
      },
      {
        "index": 1,
        "document": {
          "text": "深度学习是机器学习的子集,使用神经网络处理复杂数据。"
        },
        "relevance_score": 0.82
      },
      {
        "index": 2,
        "document": {
          "text": "自然语言处理让计算机能够理解和生成人类语言。"
        },
        "relevance_score": 0.71
      }
    ]
  }
}

调用示例

curl "https://api.tinyaii.cn/v1/rerank?apikey=YOUR_KEY&query=什么是机器学习&documents=["机器学习是人工智能的一个分支", "今天天气不错", "深度学习是机器学习的子领域"]&top_n=3"

把 YOUR_KEY 换成你在 用户中心 获取的 API Key,在浏览器打开同样地址也能直接看到结果。

相关接口(AI 能力)

本站收录 353 个可免费调用的 API 接口,查看完整开发文档 或 注册获取 API Key。