跳转到主要内容
POST
对文档重新排序
在将候选文档传递给搜索、检索或生成步骤之前,可使用此端点重新排序。 部署前请通过 GET /v1/models 验证模型。默认响应仅包含具有公共 Gateway 路由的模型。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

请求体

application/json
model
string
必填
query
string
必填
documents
必填
Minimum array length: 1
models
string[]

在 model 之后按顺序尝试的可选回退模型。model 为必填项,且始终是主模型。当某次尝试以 429、500、502、503 或 504 失败时,会尝试下一项;其他错误按原样返回。最多接受 25 个模型 ID 或预设;重复项以及与 model 相同的项会被忽略。每次尝试都会作为独立请求进行验证、记录和计费,响应中的 model 字段和路由追踪会显示实际处理请求的模型。流式请求仅在发送第一个字节之前回退,视频和音乐任务仅在提交时回退。Batch、realtime 和 council 请求会拒绝 models。动态路由上设置的回退优先,且 phaseo/auto 不能与 models 一起使用。

Required array length: 1 - 25 elements
Minimum string length: 1
示例:
top_n
integer
必填范围: x >= 1
top_k
integer

top_n 的别名。

必填范围: x >= 1
return_documents
boolean
max_chunks_per_doc
integer
必填范围: x >= 1
rank_fields
string[]
user
string
metadata
object
provider_options
object
debug
object

网关调试控制项。这些标志绝不会转发给提供商。

provider
object

用于网关选择的提供商路由偏好设置。

响应

200 - application/json

重新排序响应

object
string
id
string
nativeResponseId
string | null
model
string
results
object[]
usage
object
最后修改于 2026年11月16日