リランキングモデルは、取得されたドキュメントを再スコアリングし、最も関連性の高い結果を上位に表示します。初期検索で精度より速度を優先する場合でも、検索精度を向上させます。
注記リランキングが最も価値を発揮する場面:リランキングは、初期検索が関連性のばらついた 20~100 件以上の候補を返す場合に最も効果的です。一方、結果がすでに高精度である場合 (完全一致のキーワード検索など) は、効果が小さくなります。一般的な RAG のワークフローでは、埋め込みモデルで 50~100 件の候補を取得し、その後リランキングで上位 5~10 件を選択して大規模言語モデルに渡します。
前提条件
API キーを取得し、環境変数として設定してから、SDK をインストールします。
ドキュメントのリランキング
クエリと候補ドキュメントのリストを API に渡します。モデルは、関連性順にソートされたドキュメントを返します。
テキストリランキング (qwen3-rerank)
OpenAI 互換
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("DASHSCOPE_API_KEY"),
base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-api/v1",
)
results = client.post(
"/reranks",
body={
"model": "qwen3-rerank",
"query": "What is a reranking model?",
"documents": [
"Reranking models are widely used in search engines and recommendation systems to sort candidate texts by relevance.",
"Quantum computing is a cutting-edge field in computer science.",
"The development of pretrained language models has led to new advancements in reranking models."
],
"top_n": 2
},
cast_to=object
)
print(results)
const OpenAI = require("openai");
const openai = new OpenAI({
apiKey: process.env.DASHSCOPE_API_KEY,
baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-api/v1",
});
async function rerank() {
const results = await openai.post("/reranks", {
body: {
model: "qwen3-rerank",
query: "What is a reranking model?",
documents: [
"Reranking models are widely used in search engines and recommendation systems to sort candidate texts by relevance.",
"Quantum computing is a cutting-edge field in computer science.",
"The development of pretrained language models has led to new advancements in reranking models.",
],
top_n: 2,
},
});
console.log(JSON.stringify(results, null, 2));
}
rerank();
curl --request POST \
--url https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-api/v1/reranks \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "qwen3-rerank",
"query": "What is a reranking model?",
"documents": [
"Reranking models are widely used in search engines and recommendation systems to sort candidate texts by relevance.",
"Quantum computing is a cutting-edge field in computer science.",
"The development of pretrained language models has led to new advancements in reranking models."
],
"top_n": 2
}'
DashScope
import os
import dashscope
# 以下はシンガポールリージョンの設定です。リージョンによって region の値は異なります。呼び出し時は、{WorkspaceId} をお使いのワークスペース ID に置き換えてください。
client = dashscope.Client(
# 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: api_key="sk-xxx"
# API キーはリージョン固有です。API キーを取得するには、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください
api_key=os.getenv("DASHSCOPE_API_KEY"),
workspace="{WorkspaceId}",
region="ap-southeast-1",
)
resp = client.rerank.create(
model="qwen3-rerank",
query="What is a reranking model?",
documents=[
"Reranking models are widely used in search engines and recommendation systems to sort candidate texts by relevance.",
"Quantum computing is a cutting-edge field in computer science.",
"The development of pretrained language models has led to new advancements in reranking models."
],
top_n=2,
return_documents=True
)
print(resp)
curl --request POST \
--url https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/rerank/text-rerank/text-rerank \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "qwen3-rerank",
"input": {
"query": "What is a reranking model?",
"documents": [
"Reranking models are widely used in search engines and recommendation systems to sort candidate texts by relevance.",
"Quantum computing is a cutting-edge field in computer science.",
"The development of pretrained language models has led to new advancements in reranking models."
]
},
"parameters": {
"top_n": 2,
"return_documents": true
}
}'
マルチモーダルリランキング (qwen3-vl-rerank)
qwen3-vl-rerank モデルは、テキスト、画像、動画をリランクします。クエリはテキストまたは画像であり、ドキュメントにはこれらのモダリティの任意の組み合わせを含めることができます。
注記マルチモーダルリランキングは、OpenAI 互換のエンドポイントではなく、DashScope SDK または API からのみ利用できます。
import os
import dashscope
import json
# 以下は中国 (北京) リージョンの設定です。リージョンによって region の値は異なります。呼び出し時は、{WorkspaceId} をお使いのワークスペース ID に置き換えてください。
client = dashscope.Client(
# 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: api_key="sk-xxx"
# API キーはリージョン固有です。API キーを取得するには、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください
api_key=os.getenv("DASHSCOPE_API_KEY"),
workspace="{WorkspaceId}",
region="cn-beijing",
)
resp = client.rerank.create(
model="qwen3-vl-rerank",
query={"text": "What is a text reranking model"},
documents=[
{"text": "Text reranking models are widely used in search engines and recommender systems."},
{"image": "https://img.alicdn.com/imgextra/i3/O1CN01rdstgY1uiZWt8gqSL_!!6000000006071-0-tps-1970-356.jpg"},
{"video": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250107/lbcemt/new+video.mp4"}
],
top_n=2,
return_documents=True
)
print(json.dumps(resp.model_dump(), ensure_ascii=False, indent=4))
curl --request POST \
--url https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/rerank/text-rerank/text-rerank \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "qwen3-vl-rerank",
"input": {
"query": {"text": "What is a text reranking model"},
"documents": [
{"text": "Text reranking models are widely used in search engines and recommender systems."},
{"image": "https://img.alicdn.com/imgextra/i3/O1CN01rdstgY1uiZWt8gqSL_!!6000000006071-0-tps-1970-356.jpg"},
{"video": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250107/lbcemt/new+video.mp4"}
]
},
"parameters": {
"return_documents": true,
"top_n": 2,
"fps": 1.0
}
}'
主要機能
指示 (instruct) によるリランキング
instruct パラメーターは、ランキング戦略を設定します。指示は英語で記述してください。
-
質問応答検索 (デフォルト):
「Web 検索クエリが与えられると、クエリに回答する関連パッセージを取得します。」回答の発見に重点を置きます。「How to prevent a cold?」では、トピックとして関連するものの回答ではない「A cold is a common illness,」よりも、「Washing hands frequently can prevent colds」の方が高いスコアになります。
-
セマンティック類似性:
「意味的に類似したテキストを取得します。」意味的な同等性に重点を置き、表現の違いに強くなります。「How do I change my password?」は「What if I forgot my password?」にマッチします。FAQ の重複排除に有用です。
設定されていない場合は、質問応答検索がデフォルトです。
curl --request POST \
--url https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-api/v1/reranks \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "qwen3-rerank",
"query": "How do I change my password?",
"documents": [
"Go to Settings > Security > Change Password to update your credentials.",
"What if I forgot my password?",
"Our platform supports two-factor authentication."
],
"instruct": "Retrieve semantically similar text."
}'
import os
import dashscope
# 以下はシンガポールリージョンの設定です。リージョンによって region の値は異なります。呼び出し時は、{WorkspaceId} をお使いのワークスペース ID に置き換えてください。
client = dashscope.Client(
# 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: api_key="sk-xxx"
# API キーはリージョン固有です。API キーを取得するには、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください
api_key=os.getenv("DASHSCOPE_API_KEY"),
workspace="{WorkspaceId}",
region="ap-southeast-1",
)
resp = client.rerank.create(
model="qwen3-rerank",
query="How do I change my password?",
documents=[
"Go to Settings > Security > Change Password to update your credentials.",
"What if I forgot my password?",
"Our platform supports two-factor authentication."
],
instruct="Retrieve semantically similar text."
)
print(resp)
上位 N 件の結果の返却 (top_n)
top_n を使用すると、上位のドキュメントのみが返されます。 top_n が設定されていない場合、すべてのドキュメントが関連度順にソートされて返されます。 top_n が入力ドキュメント数を超えた場合、すべてのドキュメントが返されます。
モデル概要
重要gte-rerank モデルは 2026 年 5 月 30 日に提供終了となりました。qwen3-rerank に切り替えてください。
Singapore
モデル | 最大ドキュメント数 | ドキュメントあたりの最大トークン数 | リクエストあたりの最大トークン数 | 対応言語 | ユースケース |
|---|---|---|---|---|---|
qwen3-rerank | 500 | 32,768 | 120,000 | 100 以上の言語 | セマンティックテキスト検索、RAG アプリケーション |
Beijing
モデル | 最大ドキュメント数 | ドキュメントあたりの最大トークン数 | リクエストあたりの最大トークン数 | 対応言語 | ユースケース |
|---|---|---|---|---|---|
qwen3-vl-rerank | Text: 100 Image: 40 Video: 4 | 8,000 | 120,000 | 33 言語 | マルチモーダル検索結果のリランキング (テキスト、画像、動画) |
gte-rerank-v2 | 500 | 4,000 | 30,000 | 50 以上の言語 | セマンティックテキスト検索、RAG アプリケーション |
- ドキュメントあたりの最大トークン数:単一のクエリまたはドキュメントの最大トークン数です。単一のクエリまたはドキュメントの入力がこの上限を超えると、API は HTTP 400 エラーを返し、入力内容は切り捨てられません。
- 最大ドキュメント数:リクエストあたりの最大ドキュメント数です。qwen3-vl-rerank の場合、この上限はドキュメントタイプ (テキスト、画像、動画、またはこれらの組み合わせ) によって異なります。
- リクエストあたりの最大トークン数:
クエリトークン数 × ドキュメント数 + ドキュメントの合計トークン数。
関連 API
詳細については、「リランキング API リファレンス」をご参照ください。
エラーコード
呼び出しが失敗した場合は、エラーコードをご参照ください。
レート制限
詳細については、「レート制限」をご参照ください。