重排序（Rerank）

重排序接口用于对搜索结果进行语义重排。

接口地址

POST https://ai-tokenhub.com/v1/rerank

请求头

名称	类型	必填	说明
Authorization	string	是	Bearer YOUR_API_KEY
Content-Type	string	是	application/json

请求体

参数	类型	必填	说明
model	string	是	重排序模型标识符
query	string	是	查询文本
documents	array	是	要重排的文档列表
top_n	integer	否	返回数量

请求示例

curl https://ai-tokenhub.com/v1/rerank \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "rerank-3",
    "query": "What is AI?",
    "documents": [
      "Artificial intelligence is...",
      "Machine learning is...",
      "Deep learning is..."
    ],
    "top_n": 3
  }'

响应示例

{
  "object": "list",
  "results": [
    {
      "index": 0,
      "document": "Artificial intelligence is...",
      "relevance_score": 0.95
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "total_tokens": 20
  }
}

应用场景

• 搜索优化: 提升搜索结果相关性
• 推荐排序: 优化内容推荐顺序
• 问答系统: 检索最相关答案