重排序

​

前提条件

​

文档重排序

import os
from openai import OpenAI

client = OpenAI(
  api_key=os.getenv("DASHSCOPE_API_KEY"),
  base_url="https://dashscope.aliyuncs.com/compatible-api/v1",
)

results = client.post(
  "/reranks",
  body={
    "model": "qwen3-rerank",
    "query": "什么是重排序模型",
    "documents": [
      "重排序模型广泛应用于搜索引擎和推荐系统，用于按相关性对候选文本排序",
      "量子计算是计算科学的前沿领域",
      "预训练语言模型的发展为重排序模型带来了新的突破"
    ],
    "top_n": 2
  },
  cast_to=object
)

print(results)

import dashscope
from http import HTTPStatus

dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1'

resp = dashscope.TextReRank.call(
  model="qwen3-rerank",
  query="什么是重排序模型",
  documents=[
    "重排序模型广泛应用于搜索引擎和推荐系统，用于按相关性对候选文本排序",
    "量子计算是计算科学的前沿领域",
    "预训练语言模型的发展为重排序模型带来了新的突破"
  ],
  top_n=2,
  return_documents=True
)

if resp.status_code == HTTPStatus.OK:
  print(resp)

​

核心功能

​

使用指令优化排序（instruct）

• 问答检索（默认）："Given a web search query, retrieve relevant passages that answer the query."
  • 侧重：找到答案。对于查询"How to prevent colds?"，"Washing hands frequently prevents colds" 的得分高于 "The common cold is a widespread illness"（虽然主题相关但未回答问题）。
• 语义相似度："Retrieve semantically similar text."
  • 侧重：语义等价，不受措辞影响。例如在 FAQ 场景中，"How to change my password?" 会匹配 "What if I forgot my password?"。

curl --request POST \
  --url https://dashscope.aliyuncs.com/compatible-api/v1/reranks \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "qwen3-rerank",
    "query": "How to change my password?",
    "documents": [
      "Click 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 dashscope
from http import HTTPStatus

dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1'

resp = dashscope.TextReRank.call(
  model="qwen3-rerank",
  query="How to change my password?",
  documents=[
    "Click 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."
)

if resp.status_code == HTTPStatus.OK:
  print(resp)

​

返回前 N 个结果（top_n）

​

支持的模型

• 单文档最大 Token 数：每条查询或文档的最大 Token 数。超出部分会被截断，排序结果仅基于截断后的内容计算，可能影响排序精度。
• 最大文档数：单次请求允许的最大文档数量。
• 单请求最大 Token 数：计算方式为 查询 Token 数 x 文档数量 + 所有文档 Token 总数，不得超过单请求限制。

​

API 参考

• OpenAI 兼容端点
• DashScope 端点

​

错误码

​

限流