API 参考
重排序
POST /v2/rerank 对候选文档重排序,用于 RAG 检索结果精排。
POST https://api.tokrouter.dev/v2/rerank
Authorization: Bearer sk-…curl https://api.tokrouter.dev/v2/rerank \
-H "Authorization: Bearer $TOKROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-rerank",
"query": "什么是 SSE",
"documents": [
"SSE 是服务器发送事件,基于 HTTP 的单向流。",
"WebSocket 是全双工协议。",
"今天天气不错。"
],
"top_n": 2
}'请求字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | rerank 模型 id,见模型 |
query | string | 是 | 查询文本 |
documents | array | 是 | 候选文档(字符串,或带 text 的对象) |
top_n | integer | 否 | 只返回前 N 条 |
响应
{
"results": [
{"index": 0, "relevance_score": 0.93},
{"index": 1, "relevance_score": 0.21}
],
"usage": {"total_tokens": 48}
}index 指向请求里 documents 的下标,按 relevance_score 降序。
计费
rerank 模型只有输入 token,没有输出 token —— 价目表里输出一列为 —。