Rerank 模型兼容性与字段迁移

本页把官方最新重排模型与本站当前统一入口分开说明，避免把上游模型页面直接当成青云TOP API 的可用清单。

官方模型（上游参考）

官方模型 ID	官方能力	本站使用边界
`Qwen/Qwen3-Reranker-8B`	文本重排序，官方支持 instruction。	当前统一 DTO 使用 `query: string` 与数组 documents；调用前仍需 GET /v1/models 确认映射。
`Qwen/Qwen3-Reranker-4B`	文本重排序，官方支持 instruction。	同上；不能因为官方存在就假定当前分组可用。
`Qwen/Qwen3-Reranker-0.6B`	文本重排序，官方支持 instruction。	同上；用当前列表返回的完整 ID。
`Qwen/Qwen3-VL-Reranker-8B`	文本、图片及组合内容的多模态重排序。	当前 New API DTO 的 query 为字符串，未确认对象 query/document 的本站入口。
`BAAI/bge-reranker-v2-m3`	多语言文本重排序。	New API rc.41 SiliconFlow 内置模型清单明确包含它；仍受账号和分组限制。
`Pro/BAAI/bge-reranker-v2-m3`	SiliconFlow Pro 变体。	官方目录可见，本站是否有对应渠道映射以 GET /v1/models 为准。
`netease-youdao/bce-reranker-base_v1`	文本重排序。	New API rc.41 SiliconFlow 内置模型清单明确包含它；仍受账号和分组限制。

字段名迁移

语义	当前青云TOP DTO	SiliconFlow 官方页面
指令	`instruct`	`instruction`
长文档切片上限	`max_chunk_per_doc`	`max_chunks_per_doc`

当前文档按 New API DTO 写 Request schema。除非你的部署和渠道明确提供字段映射，不要把官方页面的 instruction 或 max_chunks_per_doc 直接替换进本站请求；未知字段可能被解码丢弃，或由上游返回参数错误。

多模态限制

SiliconFlow 官方 Rerank 页面允许 Qwen3-VL-Reranker-8B 使用图片 URL/Base64 对象。当前 New API RerankRequest 将 query 声明为字符串，将 documents 声明为数组；该宿主协议不能据此承诺多模态对象会被正确解码或转发。需要多模态重排时，先确认部署版本、渠道 adaptor 和 /v1/models 返回，再通过实际配置的专用入口调用。

迁移检查

用 GET /v1/models 确认完整模型 ID 和分组权限。
用一个 query 和两个短文本 documents 做离线格式检查。
只在模型明确支持时加入 instruct、切片或重叠参数。
读取 results[].index 回指原文；不要用返回数组位置替代 index。
生产环境记录 HTTP 状态、脱敏错误、模型 ID 和请求追踪标识，不记录 API Key 或完整敏感文档。

参考：SiliconFlow 创建重排序请求、SiliconFlow 模型目录、New API v1.0.0-rc.41。