---
title: "文本重排序接口"
method: POST
path: "/rerank"
tags: ["Rerank"]
---

# 文本重排序接口

`POST /rerank`

根据查询对文档列表进行相关性排序，适用于搜索结果优化、问答系统等场景。

## Request body

- object
  - `model` string, required — 重排模型
  - `query` string, required — 重排提示
  - `documents` string[], required — 用于重新排序的字符串数组
  - `top_n` integer — 返回前N个最匹配结果
  - `retries` integer — 自动重试次数，默认0，表示失败不重试

## Response `200`

成功响应

- object
  - `model` string, required — 使用的重排模型
  - `results` object[], required — 重排序结果列表
    - `document` string — 文档内容(当return_documents=true时返回)
    - `index` integer, required — 原始文档索引
    - `relevance_score` number, float, required — 相关性得分(0-1之间)
  - `usage` object, required
    - `total_tokens` integer, required — 总消耗token数
    - `query_tokens` integer — 查询消耗token数
    - `documents_tokens` integer — 文档消耗token数
  - `metadata` object — 额外的元数据信息

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `413` — 输入内容超出限制
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)