开发者文档

完整的 API 文档,兼容 OpenAI 接口标准

POST/v1/rerank

文档重排序

根据查询对文档列表进行相关性重排序,返回按相关性排序的文档列表。

请求地址

POST https://token.wlj.weifaner.net:8001/v1/rerank

请求头

参数名类型必填说明
AuthorizationstringBearer Token 认证
Content-Typestringapplication/json

请求体

参数名类型必填说明
modelstring重排序模型,如 rerank-english-v2.0
querystring查询文本
documentsarray要重排序的文档列表
top_ninteger返回最相关的文档数量
return_documentsboolean是否在响应中返回文档内容(默认 true)

请求示例

curl -X POST https://token.wlj.weifaner.net:8001/v1/rerank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rerank-english-v2.0",
    "query": "什么是机器学习?",
    "documents": [
      "机器学习是人工智能的一个分支...",
      "深度学习是机器学习的一种方法...",
      "Python 是一种编程语言..."
    ],
    "top_n": 2
  }'

响应示例

{
  "id": "xxx",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.987,
      "document": {
        "text": "机器学习是人工智能的一个分支..."
      }
    },
    {
      "index": 1,
      "relevance_score": 0.876,
      "document": {
        "text": "深度学习是机器学习的一种方法..."
      }
    }
  ],
  "meta": {
    "api_version": {
      "version": "1"
    },
    "billed_units": {
      "search_units": 1
    }
  }
}

最后更新于 2026/5/25