# 重排序

> POST /v2/rerank 对候选文档重排序,用于 RAG 检索结果精排。

```
POST https://api.tokrouter.dev/v2/rerank
Authorization: Bearer sk-…
```

```bash
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,见[模型](/zh/models/) |
| `query` | string | 是 | 查询文本 |
| `documents` | array | 是 | 候选文档(字符串,或带 `text` 的对象) |
| `top_n` | integer | 否 | 只返回前 N 条 |

## 响应

```json
{
  "results": [
    {"index": 0, "relevance_score": 0.93},
    {"index": 1, "relevance_score": 0.21}
  ],
  "usage": {"total_tokens": 48}
}
```

`index` 指向请求里 `documents` 的下标,按 `relevance_score` 降序。

## 计费

rerank 模型只有输入 token,没有输出 token —— 价目表里输出一列为 `—`。