v1

latestOpenAPI 3.1.02026-07-2634132204.7 KB

Rerank

文本重排序接口

根据查询对文档列表进行相关性排序，适用于搜索结果优化、问答系统等场景。

post/rerank

Request body

modelstring required

重排模型

querystring required

重排提示

documentsstring[] required

用于重新排序的字符串数组

top_ninteger

返回前N个最匹配结果

retriesinteger

自动重试次数，默认0，表示失败不重试

Example request

{
  "model": "rerank-multilingual-v3.0",
  "query": "美国首都是哪里?",
  "documents": [
    "待重排文本1",
    "待重排文本2",
    "待重排文本3"
  ],
  "top_n": 10
}

Response

成功响应

modelstring required

使用的重排模型

metadataobject

额外的元数据信息

Example response

{
  "model": "rerank-multilingual-v3.0",
  "results": [
    {
      "document": "华盛顿特区是美国的首都",
      "relevance_score": 0.89
    }
  ],
  "usage": {
    "total_tokens": 256,
    "query_tokens": 32,
    "documents_tokens": 224
  }
}