Passer au contenu principal
POST
Reclasser les documents
Utilisez ce point de terminaison pour réordonner les documents candidats avant de les transmettre à une étape de recherche, de récupération ou de génération. Vérifiez le modèle avec GET /v1/models avant le déploiement. La réponse par défaut ne contient que les modèles ayant une route Gateway publique.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Corps

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

Modèles de repli facultatifs et ordonnés, essayés après model. model est obligatoire et reste toujours le modèle principal. Lorsqu'une tentative échoue avec 429, 500, 502, 503 ou 504, l'entrée suivante est essayée ; les autres erreurs sont renvoyées telles quelles. Accepte jusqu'à 25 identifiants de modèle ou préréglages ; les doublons et les entrées identiques à model sont ignorés. Chaque tentative est validée, journalisée et facturée comme une requête distincte, et le champ model de la réponse ainsi que la trace de routage indiquent le modèle qui a servi la requête. Les requêtes en streaming ne basculent qu'avant le premier octet, et les tâches vidéo et musique uniquement lors de leur soumission. Les requêtes batch, realtime et council rejettent models. Les replis définis sur une route dynamique sont prioritaires, et phaseo/auto ne peut pas être combiné avec models.

Required array length: 1 - 25 elements
Minimum string length: 1
Exemple:
top_n
integer
Plage requise: x >= 1
top_k
integer

Alias de top_n.

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

Options de débogage de la passerelle. Ces indicateurs ne sont jamais transmis au fournisseur.

provider
object

Préférences de routage des fournisseurs pour la sélection par la passerelle.

Réponse

200 - application/json

Réponse de reclassement

object
string
id
string
nativeResponseId
string | null
model
string
results
object[]
usage
object
Dernière modification le 16 novembre 2026