Cohere: Rerank v3.5
Cohere Rerank 3.5 は、クエリとの関連度に基づき、候補テキストと半構造化レコードを並べ替えます。100 を超える言語と 4096 トークンのコンテキストに対応し、回答の作成や検索結果の表示の前に、キーワード検索や意味検索の結果を改善します。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Cohere Rerank 3.5 は、候補文書と半構造化テキストの関連度順位付けを行う多言語モデルです。クエリに対して各候補を評価し、関連度スコア付きの並べ替え済み結果一覧を返します。キーワード検索や意味検索から得た候補を改善し、検索拡張型の回答に使う文章を選べます。役割は、自由形式の回答を生成したり、新しいコーパス索引を作ったりすることではなく、根拠の並び順を改善することです。
開発元の正確な識別子は rerank-v3.5 です。4096 トークンのコンテキストを使い、Rerank 4 Pro と Fast の 32K コンテキストとは異なります。クエリと文書のトークンは、候補ごとのこのウィンドウに合算されます。モデル固有の準備ガイドでは、2048 トークンを超えるクエリを先頭部分に切り詰め、クエリを考慮する前の文書チャンクを 4093 トークンとして説明しています。クエリの焦点を絞り、求める関係を判断するのに必要な情報を含む候補文章を用意します。
クエリと候補テキスト文字列の一覧を提供します。各結果には、元の文書位置を指すインデックスと、関連度スコアが含まれます。top_n は、保持する順位付き結果の数を選びます。省略した場合、文書化された開発元ワークフローはすべての結果を返します。最上位の文章を元の方針、製品レコード、メッセージまでたどれるよう、文書識別子をスコアとは独立して保持してください。
Rerank 3.5 は、英語と英語以外の資料を含む、100 を超える言語に対応します。クエリには、製品、ユーザーの状況、必要な手順など、要望の複数の側面を含められます。構造化レコードについて、V2 リリースは生の文書オブジェクトを廃止し、YAML 文字列を推奨しています。長い文字列は切り詰められることがあるため、決定的な内容を関連度の低いメタデータより先に置き、有用なフィールドを意図した順序で保ちます。タイトルと本文、製品属性、メッセージの件名と本文などに使えます。
V2 の開発元リファレンスは、文書の切り詰めに max_tokens_per_doc を使い、既定値は 4096 です。Cohere の準備ガイドでは、長い文書のチャンク化も説明しています。有効な入力は、選んだワークフローと文書設定に依存します。より細かく制御するには、長い出典のすべての節が見えると仮定せず、自分で識別可能な文章を準備します。答えを含む文章と、単に同じ語彙を使う文章を区別できるだけの周辺文脈を保持してください。
リクエスト性能について、現在のリファレンスは、1度に 1,000 文書を超えて送らないことを推奨しています。関連度スコアは 0〜1 に正規化されますが、値はクエリと候補に依存し、正しさの線形尺度ではありません。順位を使って有用な根拠を特定します。スコア閾値が必要な場合は、分野を代表するクエリと、関連性が境界にある文章を選び、実際の検索タスクを反映した閾値にします。
実用的なサポートのワークフローでは、破損商品の質問に対し、候補となる返品方針の節を並べ替え、選んだ原文を回答作成の工程へ渡せます。メール検索では、特定の問題についてメッセージを順位付けし、各結果に元のメッセージ識別子を残せます。有用な成果物は、順序付けされた根拠の一覧です。その結果には、後発モデルの上限に置き換えるのではなく、Rerank 3.5 の短いコンテキストと V2 の文書準備条件を添えて保持します。
Ailoot Ultra · 再ランキング POST /v1/rerank cohere/rerank-v3.5
cohere/rerank-v3.5はじめに
Cohere Rerank 3.5 は、クエリとの関連度に基づき、候補テキストと半構造化レコードを並べ替えます。100 を超える言語と 4096 トークンのコンテキストに対応し、回答の作成や検索結果の表示の前に、キーワード検索や意味検索の結果を改善します。
- 対応する入力
- テキスト
- 結果
- 順位付きの結果
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 再ランキング POST /v1/rerank
- 入力の種類
text- 出力の種類
rerank- 出力形式
- json
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドdocuments | 種類array | 要件必須 | 値と制限 | デフォルト— |
フィールドmodel | 種類string | 要件必須 | 値と制限 cohere/rerank-v3.5 | デフォルト— |
フィールドprovider | 種類schema | 要件任意 | 値と制限 | デフォルト— |
フィールドquery | 種類string | 要件必須 | 値と制限 | デフォルト— |
フィールドsession_id | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドtop_n | 種類integer | 要件任意 | 値と制限 最小値: 1 | デフォルト— |
フィールドtrace | 種類schema | 要件任意 | 値と制限 | デフォルト— |
フィールドuser | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドdocuments[].text | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドdocuments[].image | 種類string | 要件任意 | 値と制限 | デフォルト— |
入力素材の組み合わせ
text_rerank · 必須: query, documents array with minItems1
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, query, documents |
パラメータmaterial_types | 仕様text |
パラメータoptional_controls | 仕様provider, session_id, top_n, trace, user |
パラメータmultimodal_input_binding | 仕様null |
ライフサイクル: synchronous
正確なモデルIDを送信し、ネイティブのレスポンス全体を保持してください。
料金
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値(default)を使用する場合
Ailootの料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 課金単位 | 料金 |
|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 課金単位— | 料金 入力 · 入力トークン — / 1K トークン 出力 · 出力トークン — / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定Ultra | 料金表— | 課金単位検索単位あたり | 料金 total · 検索単位 $0.002 検索単位あたり |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · 再ランキング
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "cohere/rerank-v3.5",
"query": "What is the capital of France?",
"top_n": 3
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cohere/rerank-v3.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
結果を受け取って保存
Ailoot Ultra · 再ランキング
json
完了した結果をすべて保存
返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。
実際の結果の各インデックス、有限値のrelevance_score、元の文書オブジェクトはすべて保持されます。インデックスは元の文書配列に対応します。元のJSON全体は保存され、精算後にのみ返されます。
元のレスポンスを確認する場合
元の操作と、完全または部分的な応答を保持してください。POSTを再実行しないでください。
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドmodel | 種類string |
フィールドid | 種類string |
フィールドprovider | 種類string |
フィールドresults[].index | 種類integer |
フィールドresults[].relevance_score | 種類number |
フィールドresults[].document.text | 種類string |
フィールドresults[].document.image | 種類string |
フィールドusage.search_units | 種類integer |
フィールドusage.total_tokens | 種類integer |
フィールドusage.cost | 種類number |
エラーと次の手順
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス400 · invalid_request_error | 条件必須フィールド、表現形式、または値が無効です | 次の手順指摘されたリクエストフィールドを修正してください。 |
エイリアス
モデルのエイリアス
Ailoot Ultra cohere/rerank-v3.5
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · Cohere: Rerank v3.5
- 利用できる入力と結果は何ですか?
POST /v1/rerank·cohere/rerank-v3.5:text→rerank- リクエストはどの項目を使用しますか?
POST /v1/rerank·cohere/rerank-v3.5:documents,model,provider,query,session_id,top_n,trace,user- どの制限が適用されますか?
POST /v1/rerank·cohere/rerank-v3.5:top_n.minimum:1