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

# Rerank v4.0 Fast

> Cohere 注重响应速度的多语言相关性重排序模型。

Cohere 注重响应速度的多语言相关性重排序模型。

## 模型信息

| 字段         | 说明               |
| ---------- | ---------------- |
| `model`    | rerank-v4.0-fast |
| `context`  | 32,768 tokens    |
| `endpoint` | POST /v1/rerank  |

上下文和输出长度为模型规格；实际请求限制、可用性与计费取决于 MixRoute 路由。

## 能力与使用

* 根据 query 对候选 documents 进行排序，不生成回答或向量。
* 上下文限制针对查询与单篇文档的组合。先召回候选文档，再通过 top\_n 选出最相关结果。
* results\[].index 对应原始 documents 数组的位置，应使用该索引取回文档，而不是假设响应始终包含原文。

## 请求示例

调用前设置 `MIXROUTE_API_KEY`。

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/rerank" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "rerank-v4.0-fast",
  "query": "API documentation",
  "documents": [
    "An API reference for developers.",
    "A recipe for soup."
  ],
  "top_n": 1
}'
```

## 请求字段

| 字段          | 说明                 |
| ----------- | ------------------ |
| `model`     | 必填，使用上方完整模型 ID。    |
| `query`     | 必填，查询文本。           |
| `documents` | 必填，候选文档字符串数组。      |
| `top_n`     | 可选，返回条数，不超过候选文档数量。 |

完整请求格式见[接口说明](/cn/api-reference/endpoint/rerank)。
