DashScope 重排序 - 千问AI平台

POST

/services/rerank/text-rerank/text-rerank

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/rerank/text-rerank/text-rerank' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "qwen3.7-text-rerank",
  "input": {
    "query": "什么是文本排序模型",
    "documents": [
      "文本排序模型广泛用于搜索引擎和推荐系统中，它们根据文本相关性对候选文本进行排序",
      "量子计算是计算科学的一个前沿领域",
      "预训练语言模型的发展给文本排序模型带来了新的进展"
    ]
  },
  "parameters": {
    "top_n": 2,
    "instruct": "Given a web search query, retrieve relevant passages that answer the query."
  }
}'

{
  "output": {
    "results": [
      {
        "document": {
          "text": "<string>"
        },
        "index": 0,
        "relevance_score": 0.9334521178273196
      }
    ]
  },
  "usage": {
    "prompt_tokens": 0,
    "total_tokens": 0
  },
  "request_id": "85ba5752-1900-47d2-8896-23f99b13f6e1"
}

使用 qwen3-rerank 模型根据语义相关性对文档进行重排序。采用嵌套请求结构，通过 input 和 parameters 组织请求参数。

开始之前：获取 API Key、将其设置为环境变量，如果使用 SDK，还需安装 DashScope SDK。

接入点

HTTP：POST https://dashscope.aliyuncs.com/api/v1/services/rerank/text-rerank/text-rerank
SDK base_http_api_url：https://dashscope.aliyuncs.com/api/v1

模型概览

模型	最大文档数	单文档最大 Token 数	请求最大 Token 数	支持语言	适用场景
qwen3-rerank	500	4,000	120,000	100+ 种语言	文本语义搜索、RAG

关于模型计费，请参见模型市场。 参数说明：

单文档最大 Token 数：单条查询或文档允许的最大 Token 数量。单条查询或文档的输入超过该限制时，API 会返回 HTTP 400 错误，不会截断输入内容。
最大文档数：单次请求允许的最大文档数量。
请求最大 Token 数：计算公式为 查询 Token 数 x 文档数量 + 所有文档 Token 总数，不得超过此限制。

鉴权

string

header

必填

千问AI平台 API Key。详见获取 API Key。

请求体

application/json

enum<string>

必填

模型名称。可选值：qwen3.7-text-rerank、qwen3-vl-rerank、gte-rerank-v2（将于 2026-05-30 下线，推荐使用 qwen3-rerank）。

可选值：qwen3.7-text-rerank,qwen3-vl-rerank,gte-rerank-v2

示例:qwen3-vl-rerank

object

必填

输入数据，包含查询和待排序文档。

显示子属性

string

必填

查询内容。最大 4,000 个 token。字符串格式或对象格式（qwen3-vl-rerank 支持 {"text": "..."} 或 {"image": "URL"}）。

示例:What is a reranking model

(string | object)[]

必填

待排序的文档列表。gte-rerank-v2 使用字符串数组；qwen3-vl-rerank 使用对象数组，支持 text、image、video 三种模态。最多 100 篇文档（qwen3-vl-rerank）或 500 篇文档（gte-rerank-v2）。

string
object

object

重排序请求的配置参数，需封装在此 parameters 对象中。

显示子属性

integer

仅返回得分最高的前 N 个结果。默认返回全部文档。

示例:2

取值范围：x >= 1

boolean

默认值false

是否在结果中返回原始文档内容。默认值：false。支持的模型：gte-rerank-v2、qwen3-vl-rerank。

示例:true

string

自定义排序任务指令，建议使用英文。仅 qwen3.7-text-rerank 和 qwen3-vl-rerank 支持。默认行为为问答检索："Given a web search query, retrieve relevant passages that answer the query."

示例:Given a web search query, retrieve relevant passages that answer the query.

number

默认值1

仅 qwen3-vl-rerank 支持。控制视频的帧采样比例，范围为 [0, 1]。默认值：1.0。值越小，实际抽取的帧数越少。

示例:1

响应

200-application/json

object

输出包装对象，包含排序结果。

显示子属性

object[]

排序结果，按 relevance_score 从高到低排列。

显示子属性

object

原始文档内容。仅当 return_documents 为 true 时返回。

显示子属性

string

文档的文本内容。

integer

该文档在输入 documents 列表中的原始位置索引。

示例:0

number

相关度评分，范围 0.0 到 1.0，分值越高表示相关性越强。该分值为本次请求的相对分数，不可跨请求比较。

示例:0.9334521178273196

object

Token 用量统计。

显示子属性

integer

仅 qwen3.7-text-rerank 返回。表示本次请求输入内容的 Token 总数。

integer

本次请求消耗的 Token 总数，用于计量计费和审计。

string

请求的唯一标识符。

示例:85ba5752-1900-47d2-8896-23f99b13f6e1

​接入点

​模型概览

鉴权

请求体

响应

接入点

模型概览