# 候选重排

> Rerank：按查询与候选文档的相关性重新排序，用于检索后精排。
> 分组：模型接入
> 更新时间：2026-10-12
> 原文：https://www.chenra.com/docs/model-rerank

## 候选重排（Rerank）

给一个查询与一批候选文档，由重排模型按相关性重新排序，常用于检索后的精排。

支持的模型在「模型清单」里标有能力「候选重排」，例如 gte-rerank-v2、rerank。

## 候选重排

`POST /rerank`

Jina / Cohere 形状的重排接口：给 query 与 documents，返回按相关性排序的结果。

### 请求参数

| 参数 | 类型 | 必填 | 说明 | 默认值 |
| --- | --- | --- | --- | --- |
| model | string | 是 | 重排模型标识 |  |
| query | string | 是 | 查询文本 |  |
| documents | string[] | 是 | 候选文档数组（亦可用 docs） |  |
| top_n | integer | 否 | 只返回前 N 条；不传返回全部 |  |

### 请求示例

```bash
curl https://api.chenra.com/api/relay/v1/rerank \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gte-rerank-v2",
    "query": "如何重置密码",
    "documents": ["忘记密码怎么办", "如何修改绑定手机号", "账户被冻结的处理方式"],
    "top_n": 2
  }'
```

### 响应示例

```json
{
  "model": "gte-rerank-v2",
  "results": [
    { "index": 0, "relevance_score": 0.98 },
    { "index": 2, "relevance_score": 0.21 }
  ],
  "usage": { "total_tokens": 42 }
}
```

### 错误码

| 错误码 | 说明 |
| --- | --- |
| 400 | 缺少 query 或 documents 参数 |
| 404 | 模型不存在或未启用 |