Saltar al contenido principal
POST
Reordenar documentos por relevancia
Usa este endpoint para reordenar los documentos candidatos antes de pasarlos a una búsqueda, recuperación o paso de generación. Verifica el modelo en GET /v1/models antes del despliegue. La respuesta predeterminada solo contiene modelos con una ruta pública de Gateway.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

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

Modelos de respaldo opcionales y ordenados que se prueban después de model. model es obligatorio y siempre es el modelo principal. Cuando un intento falla con 429, 500, 502, 503 o 504, se prueba la siguiente entrada; los demás errores se devuelven sin cambios. Acepta hasta 25 IDs de modelo o presets; se ignoran los duplicados y las entradas iguales a model. Cada intento se valida, registra y factura como una solicitud independiente, y el campo model de la respuesta y la traza de enrutamiento muestran el modelo que atendió la solicitud. Las solicitudes en streaming solo recurren a un respaldo antes del primer byte, y los trabajos de video y música solo al enviarse. Las solicitudes de batch, realtime y council rechazan models. Los respaldos definidos en una ruta dinámica tienen prioridad, y phaseo/auto no se puede combinar con models.

Required array length: 1 - 25 elements
Minimum string length: 1
Ejemplo:
top_n
integer
Rango requerido: x >= 1
top_k
integer

Alias de top_n.

Rango requerido: x >= 1
return_documents
boolean
max_chunks_per_doc
integer
Rango requerido: x >= 1
rank_fields
string[]
user
string
metadata
object
provider_options
object
debug
object

Controles de depuración de la pasarela. Estas opciones nunca se reenvían al proveedor.

provider
object

Preferencias de enrutamiento de proveedores para la selección de la pasarela.

Respuesta

200 - application/json

Respuesta de reordenación

object
string
id
string
nativeResponseId
string | null
model
string
results
object[]
usage
object
Última modificación el 16 de noviembre de 2026