---
url: https://limapi.com/docs/guide/rerank.md
---
# Rerank 重排序

```
POST /api/v1/rerank
Authorization: Bearer sk-xxx
Content-Type: application/json
```

对文档列表按与查询的相关性进行重排序，常用于 RAG 检索增强场景。

## Request

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| model | string | \* | Rerank 模型 ID |
| query | string | \* | 查询文本 |
| documents | array | \* | 待排序的文档列表 |
| top\_n | integer | 可选 | 返回 Top N 结果 |

**请求示例：**

```json
{
  "model": "gte-rerank-v2",
  "query": "什么是向量数据库？",
  "documents": [
    "向量数据库是专门存储和检索高维向量的数据库系统。",
    "关系型数据库使用表格存储结构化数据。",
    "向量检索常用于语义搜索与 RAG 场景。"
  ],
  "top_n": 2
}
```

## Response

返回按相关性排序的文档及其分数。

```json
{
  "results": [
    { "index": 0, "relevance_score": 0.98 },
    { "index": 2, "relevance_score": 0.87 }
  ],
  "usage": {
    "total_tokens": 120
  }
}
```