Skip to content

Rerank API

文本相关性排序接口,用于 RAG 检索后的精排。

POST https://api.ashpetals.com/v1/rerank

请求

bash
curl https://api.ashpetals.com/v1/rerank \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen3-Reranker-8B",
    "query": "如何优化数据库查询性能",
    "documents": [
      "数据库索引优化指南",
      "今天天气很好",
      "SQL 慢查询排查方法"
    ]
  }'

参数

参数类型说明
modelstring必填,Rerank 模型 ID(以 /v1/models 为准)
querystring必填,查询文本
documentsarray必填,待排序文档列表
top_nint可选,返回前 N 条结果

返回

json
{
  "results": [
    { "index": 0, "relevance_score": 0.98 },
    { "index": 2, "relevance_score": 0.87 },
    { "index": 1, "relevance_score": 0.12 }
  ]
}

注意事项

  • Rerank 模型按次计费,价格以 模型广场 为准。
  • 返回的 index 对应请求中 documents 数组的下标。

AshPetals API — 单主站 · OpenAI 兼容