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

# Rerank v5.0 Pro

> 複雑なクエリと長文書に適した、品質重視の Cohere 多言語再ランキングモデル。MixRoute のリクエスト例とレスポンスの読み方を説明します。

Rerank v5.0 Pro は、取得した文書をクエリとの関連性で並べ替えます。検索品質を重視する複雑なクエリで、候補の文章を LLM に渡す前に絞り込む用途に適しています。

候補文書を取得してから再ランキングします。返されるのは関連度スコアと元の文書のインデックスであり、回答文や埋め込みベクトルではありません。MixRoute では `/v1/rerank` を使用します。

## モデル情報

| フィールド | 説明 |
| - | - |
| `model` | rerank-v5.0-pro |
| `endpoint` | [POST /v1/rerank](https://mixroute.ai/docs/ja/api-reference/endpoint/rerank.md) |
| `context` | 32,768 tokens |

プロバイダーのコンテキスト上限は、クエリと各文書の組み合わせごとに 32,768 トークンです。文書リスト全体の上限ではありません。実際のリクエスト制限は MixRoute のルートによって異なります。

## リクエストフィールド

| フィールド | 説明 |
| - | - |
| `model` | 必須。上記の正確なモデル ID を指定します。 |
| `query` | 必須のクエリ文字列。 |
| `documents` | 必須の文書文字列の配列。インデックスから結果を対応付けられるよう、元の配列を保持します。 |
| `top_n` | 任意の正の整数。候補文書数を超えない結果数を指定します。 |
| `return_documents` | 任意の真偽値。true にすると `results[].document.text` に原文が返されます。 |

## リクエスト例

環境変数 `MIXROUTE_API_KEY` を設定してください。Python の例は requests パッケージを使用します。

> [tab] cURL
>
> ```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-v5.0-pro",
>   "query": "What is the capital of France?",
>   "documents": [
>     "Paris is the capital of France.",
>     "A triangle has three sides."
>   ],
>   "top_n": 1,
>   "return_documents": true
> }'
> ```

> [tab] Python
>
> ```python theme={null}
> import os
> import requests
>
> documents = ["Paris is the capital of France.", "A triangle has three sides."]
> response = requests.post(
>     "https://api.mixroute.ai/v1/rerank",
>     headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
>     json={
>         "model": "rerank-v5.0-pro",
>         "query": "What is the capital of France?",
>         "documents": documents,
>         "top_n": 1,
>         "return_documents": True,
>     },
>     timeout=60,
>     allow_redirects=False,
> )
> response.raise_for_status()
> result = response.json()
> if "error" in result:
>     raise RuntimeError(result["error"])
> for item in result["results"]:
>     print(item["relevance_score"], documents[item["index"]])
> print(result.get("usage", {}))
> ```

## レスポンスフィールド

`results[].index` は元の documents 配列での位置を示す、0 始まりのインデックスです。`results[].relevance_score` は関連度スコアで、値が大きいほど関連性が高くなります。`results[].document.text` は、レスポンスに原文が含まれる場合のみ読み取ります。

```json theme={null}
{
  "results": [
    {
      "document": {
        "text": "Paris is the capital of France."
      },
      "index": 0,
      "relevance_score": 0.8398325
    }
  ],
  "usage": {
    "prompt_tokens": 27,
    "completion_tokens": 0,
    "total_tokens": 27
  }
}
```

## 使用量と課金

報告されたトークン使用量は `usage.prompt_tokens` と `usage.total_tokens` で確認します。再ランキングは回答文を生成しないため、`usage.completion_tokens` は 0 になり得ます。他の汎用トークンフィールドでこれらを置き換えないでください。

現在の料金と利用可能なルートは[モデルマーケットプレイス](https://console.mixroute.ai/models)で確認できます。コンソールの消費ログには各リクエストの実際の料金が表示されます。請求の照合にはその記録を使い、usage オブジェクトをドル建ての金額として扱わないでください。

[リクエスト形式の詳細](https://mixroute.ai/docs/ja/api-reference/endpoint/rerank.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.