Cohere: Rerank 4 Pro

Cohere Rerank 4 Pro 依查詢相關性排序候選文件，適用於搜尋及檢索增強工作流程。它是著重品質的 Rerank 4 版本，具有 32K 上下文、多語言涵蓋範圍，並支援半結構化文字。

Ailoot Ultra · 重新排序 POST /v1/rerank cohere/rerank-4-pro

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

Cohere Rerank 4 Pro 是 Cohere Rerank 4 系列中著重品質的模型。它依查詢評估候選文件，傳回相關性排序及分數。模型適用於複雜檢索任務，包括多語言文件及半結構化資訊。它接在既有系統收集候選之後，融入搜尋或檢索增強工作流程：結果有助於選擇應顯示哪些段落，或將哪些段落作為佐證提供給下一階段。

開發商識別碼為 rerank-v4.0-pro，與 rerank-v4.0-fast 及 rerank-v3.5 分開。Pro 定位於以檢索品質為優先的複雜案例，Fast 則追求較低延遲與較高吞吐量。兩個 Rerank 4 版本都使用 32,768 個 token 的上下文。查詢與單一候選文件共享此額度；它不是每個輸入欄位各有完整視窗，也不是整個已儲存搜尋語料庫的限制。

提供清楚的查詢與候選文字字串清單。每個傳回結果包含原始文件索引及相關性分數，top_n 可選擇傳回多少個排序結果；省略時，開發商傳回全部結果。為每項輸入保留來源識別碼，讓排序可連回精確段落。客服問題應詢問所需條件，並提供候選政策章節，避免期待重排序模型找到清單中不存在的政策。

模型支援超過 100 種語言，可重排序英文及非英文資料。查詢包含多項需求時，指出讓段落有用的條件，例如產品、情況及所需程序。半結構化紀錄方面，Cohere 建議使用 YAML 字串，避免在 V2 文件清單傳入原始物件。刻意安排標題與內容等有意義欄位的順序，因為截斷可能移除後面的欄位。這種準備適合產品紀錄、訊息與文件中繼資料，以及一般文章。

模型專屬準備指南將 Rerank 4 查詢限制為前 16,384 個 token。指南描述透過區塊處理較長文件，區塊與查詢及保留 token 共享 32,768 個 token 的上下文。目前 V2 參考文件另外將 max_tokens_per_doc 預設為 4096，並說明較長文件字串會依此設定截斷。將模型視窗與開發商請求的文件截斷視為不同控制。準備簡潔相關段落或選擇適當文件額度，避免假設每份長來源總會被完整閱讀。

對建議請求效能，Cohere 建議一次不要傳送超過 1,000 份文件。將較大清單拆成可管理群組時，保留候選識別碼。相關性分數正規化為 0 至 1，但取決於查詢與候選；它們不是事實正確性的線性量度。以排序作為主要檢索結果。若依分數門檻篩選，使用實際領域中具代表性的查詢及接近相關邊界的段落建立門檻，避免假設有通用切點。

實用的最終產出是附來源識別碼及分數的候選排序清單，可用於搜尋結果或佐證選擇步驟。相關性分數高的文件仍可能包含過時或不正確資訊，因此要為使用它的階段保留來源與內容。Pro 的用途是相關性判斷，而非撰寫自由形式回答或生成嵌入。比較或調整檢索工作流程時，將精確的 Pro 版本與結果一併保留。

Ailoot Ultra · 重新排序 POST /v1/rerank cohere/rerank-4-pro

cohere/rerank-4-pro

Cohere /cohere/rerank-4-pro

入門

接受的輸入: 文字
結果: 已排序結果

Ailoot 可用 · 輸入與方法

Ailoot Ultra · 重新排序 POST /v1/rerank

輸入: text
輸出: rerank
輸出格式: json

欄位	類型	要求	值與限制	預設值
欄位`documents`	類型`array`	要求必填	值與限制	預設值—
欄位`model`	類型`string`	要求必填	值與限制 cohere/rerank-4-pro	預設值—
欄位`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 費率

各設定的價格

請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。

設定	費率表	計費單位	費用
設定基礎 token 費率	費率表基本費率	計費單位—	費用輸入 · 輸入 Token — / 1K Token 輸出 · 輸出 Token — / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token
設定Ultra	費率表—	計費單位每個搜尋單位	費用 total · 搜尋單位 $0.005 每個搜尋單位

Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

請求範例

Ailoot Ultra · 重新排序

原樣保留的官方請求結構；文件範例使用您的實際請求資料，並保留完整結果

{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "cohere/rerank-4-pro",
  "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-4-pro'
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-4-pro

方法路徑別名

請使用上方列出的 API 方法路徑。

Cohere: Rerank 4 Pro