Pular para o conteúdo principal
POST
Reordenar documentos
Use este endpoint para reordenar documentos candidatos antes de enviá-los para uma etapa de pesquisa, recuperação ou geração. Verifique o modelo em GET /v1/models antes da implantação. A resposta padrão contém apenas modelos com uma rota pública do Gateway.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json
model
string
obrigatório
query
string
obrigatório
documents
obrigatório
Minimum array length: 1
models
string[]

Modelos de fallback opcionais e ordenados, tentados depois de model. model é obrigatório e é sempre o modelo principal. Quando uma tentativa falha com 429, 500, 502, 503 ou 504, a próxima entrada é tentada; os demais erros são retornados sem alteração. Aceita até 25 IDs de modelo ou predefinições; duplicatas e entradas iguais a model são ignoradas. Cada tentativa é validada, registrada e cobrada como uma solicitação separada, e o campo model da resposta e o rastreamento de roteamento mostram o modelo que atendeu a solicitação. Solicitações em streaming só recorrem a um fallback antes do primeiro byte, e trabalhos de vídeo e música apenas no envio. Solicitações de batch, realtime e council rejeitam models. Fallbacks definidos em uma rota dinâmica têm precedência, e phaseo/auto não pode ser combinado com models.

Required array length: 1 - 25 elements
Minimum string length: 1
Exemplo:
top_n
integer
Intervalo obrigatório: x >= 1
top_k
integer

Alias de top_n.

Intervalo obrigatório: x >= 1
return_documents
boolean
max_chunks_per_doc
integer
Intervalo obrigatório: x >= 1
rank_fields
string[]
user
string
metadata
object
provider_options
object
debug
object

Controles de depuração do gateway. Essas opções nunca são encaminhadas ao provedor.

provider
object

Preferências de roteamento de provedores para seleção pelo gateway.

Resposta

200 - application/json

Resposta de reordenação

object
string
id
string
nativeResponseId
string | null
model
string
results
object[]
usage
object
Última modificação em 16 de novembro de 2026