> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 重排

> Rerank 文本重排接口。

## 用途

用于对候选文本结果做相关性重排。

## 请求头

<ParamField header="Authorization" type="string" default="Bearer YOUR_API_KEY" required>
  Bearer 鉴权请求头。
</ParamField>

## 请求体

<ParamField body="model" type="string" default="rerank-v1" required>
  Rerank 模型名称。
</ParamField>

<ParamField body="query" type="string" default="统一大模型网关" required>
  查询文本。
</ParamField>

<ParamField body="documents" type="string[]" default="[&#x22;HubTo 提供统一 API 入口。&#x22;,&#x22;今天上海天气晴。&#x22;]" required>
  候选文本数组。
</ParamField>

<ParamField body="top_n" type="integer" default="3">
  可选，返回前 N 条重排结果。
</ParamField>

## 示例请求体

```json theme={null}
{
  "model": "rerank-v1",
  "query": "统一大模型网关",
  "documents": [
    "HubTo 提供统一 API 入口。",
    "今天上海天气晴。"
  ]
}
```

## 响应

<ResponseField name="results" type="object[]">
  带相关性分数的重排结果。
</ResponseField>