Zum Hauptinhalt springen
POST
Dokumente neu ordnen
Verwende diesen Endpunkt, um Kandidatendokumente neu zu ordnen, bevor sie an die Suche, den Abruf oder die Generierung übergeben werden. Prüfe das Modell vor der Bereitstellung mit GET /v1/models. Die Standardantwort enthält nur Modelle mit einer öffentlichen Gateway-Route.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

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

Optionale, geordnete Fallback-Modelle, die nach model versucht werden. model ist erforderlich und immer das primäre Modell. Schlägt ein Versuch mit 429, 500, 502, 503 oder 504 fehl, wird der nächste Eintrag versucht; andere Fehler werden unverändert zurückgegeben. Akzeptiert bis zu 25 Modell-IDs oder Presets; Duplikate und Einträge, die model entsprechen, werden ignoriert. Jeder Versuch wird als eigene Anfrage validiert, protokolliert und abgerechnet, und das Feld model der Antwort sowie der Routing-Trace zeigen das Modell, das die Anfrage bedient hat. Streaming-Anfragen weichen nur vor dem ersten Byte aus, Video- und Musikjobs nur bei der Übermittlung. Batch-, Realtime- und Council-Anfragen lehnen models ab. Auf einer dynamischen Route festgelegte Fallbacks haben Vorrang, und phaseo/auto kann nicht mit models kombiniert werden.

Required array length: 1 - 25 elements
Minimum string length: 1
Beispiel:
top_n
integer
Erforderlicher Bereich: x >= 1
top_k
integer

Alias für top_n.

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

Gateway-Debug-Steuerungen. Diese Flags werden niemals an den Anbieter weitergeleitet.

provider
object

Anbieterrouting-Präferenzen für die Auswahl durch das Gateway.

Antwort

200 - application/json

Antwort zur Neusortierung

object
string
id
string
nativeResponseId
string | null
model
string
results
object[]
usage
object
Zuletzt geändert am 16. November 2026