# Dokumente nach Relevanz sortieren

Relevanzwerte im Stil von Cohere v2 mit Gateway-Erweiterungen für Textobjekte, zurückgegebene Dokumente und exakte EUR-Nutzung. Höchstens 1.000 Dokumente, 64 KiB je Suchanfrage oder Dokument und insgesamt 4 MiB Text. Kein Streaming. `top_n` wird lokal angewandt; die Originaldokumente werden immer zurückgegeben, ohne Anwendungsmetadaten an den Provider weiterzugeben. Das ältere Flag `return_documents` unterdrückt das Pflichtfeld `document` nicht, auch nicht mit `false`. Die Werte sind absteigend sortiert, gleiche Werte nach ursprünglichem Index. Unbekannte Antwortfelder werden toleriert und verworfen. Unbekannte Anfragefelder werden ignoriert und in `x-ignored-params` genannt. Alle ungültigen Felder werden gesammelt, bevor ein Provider kontaktiert wird. Routen mit Tokenpreis benötigen gemeldete Nutzung; Routen ohne Nutzungsangabe dürfen nur einen festen Anfragepreis haben. Ihre Tokenschätzung ist in `usage.estimated` ausdrücklich gekennzeichnet.

Administrative PII-Anforderungen werden für jede tatsächliche Route geprüft, einschließlich Fallbacks und Wiederholungen. Dieser Endpunkt kann seine Eingabe nicht schwärzen: Eine passende Anforderung ergibt vor jedem Provideraufruf `invalid_parameter` mit einem `not_available`-Issue an `$.model`.

`POST https://api.tokenlane.de/v1/rerank`

## Authentifizierung

[
  [
    {
      "name": "Authorization",
      "description": "API-Key als Bearer-Token im Header `Authorization`: `Authorization: Bearer sk-tl-v1-…`. Bestehende `sk-eu-`-Keys bleiben gültig. Fehlende, unbekannte oder abgelaufene Keys erhalten 401 `authentication`.",
      "type": "http bearer",
      "location": "",
      "scopes": []
    }
  ]
]

## curl

```curl
curl --request POST \
  --url 'https://api.tokenlane.de/v1/rerank' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "documents": [
    "Paris is in France.",
    {
      "text": "A recipe.",
      "title": "Cooking"
    }
  ],
  "model": "baai/bge-reranker-v2-m3",
  "query": "European capital",
  "return_documents": true,
  "top_n": 1
}'
```

## node

```node
const response = await fetch("https://api.tokenlane.de/v1/rerank", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Content-Type": "application/json",
  },
  body: `{
  "documents": [
    "Paris is in France.",
    {
      "text": "A recipe.",
      "title": "Cooking"
    }
  ],
  "model": "baai/bge-reranker-v2-m3",
  "query": "European capital",
  "return_documents": true,
  "top_n": 1
}`,
});
console.log(await response.text());
```

## python

```python
import os
import urllib.request

body = (r'''{
  "documents": [
    "Paris is in France.",
    {
      "text": "A recipe.",
      "title": "Cooking"
    }
  ],
  "model": "baai/bge-reranker-v2-m3",
  "query": "European capital",
  "return_documents": true,
  "top_n": 1
}''').encode("utf-8")

request = urllib.request.Request(
    "https://api.tokenlane.de/v1/rerank",
    method="POST",
    headers={
        "Authorization": "Bearer " + os.environ["TOKENLANE_API_KEY"],
        "Content-Type": "application/json",
    },
    data=body,
)

with urllib.request.urlopen(request) as response:
    print(response.read().decode("utf-8"))
```

## vercel

```vercel
// This operation uses HTTP directly.
const response = await fetch("https://api.tokenlane.de/v1/rerank", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Content-Type": "application/json",
  },
  body: `{
  "documents": [
    "Paris is in France.",
    {
      "text": "A recipe.",
      "title": "Cooking"
    }
  ],
  "model": "baai/bge-reranker-v2-m3",
  "query": "European capital",
  "return_documents": true,
  "top_n": 1
}`,
});
console.log(await response.text());
```

## Header: Idempotency-Key (optional)

Ausdrückliches Opt-in zur verschlüsselten Antwortwiederholung über alle Gateway-Knoten. Ein Wert aus 1 bis 255 druckbaren ASCII-Zeichen pro logischem Vorgang, begrenzt auf die Identität dieses API-Keys. Methode, Pfad und normalisierten Body unverändert wiederholen. Abgeschlossene Antworten bleiben höchstens zehn Minuten verfügbar; eine Wiederholung ist kostenlos und erzeugt keine neue Generierung. Abweichender Inhalt oder eine nicht sicher wiederholbare Antwort ergibt 409. Eine erfolgreiche Wiederholung enthält Idempotent-Replayed: true und erhält die ursprünglichen Request- und Generation-IDs. Siehe /docs/guides/idempotency.

### s0: string | null

{}

## Anfrageinhalt: application/json

```json
{
  "documents": [
    "Paris is in France.",
    {
      "text": "A recipe.",
      "title": "Cooking"
    }
  ],
  "model": "baai/bge-reranker-v2-m3",
  "query": "European capital",
  "return_documents": true,
  "top_n": 1
}
```

### s30: object

Bewertet bis zu 1.000 Dokumente anhand einer nicht leeren Suchanfrage. Text ist auf 64 KiB je Suchanfrage oder Dokument und insgesamt 4 MiB begrenzt. Zusätzliche Objektmetadaten teilen sich das Anfrageinhaltsbudget.

{}

```json
{
  "documents": [
    "Paris is in France.",
    {
      "text": "A recipe.",
      "title": "Cooking"
    }
  ],
  "model": "baai/bge-reranker-v2-m3",
  "query": "European capital",
  "return_documents": true,
  "top_n": 1
}
```

- documents (Pflichtfeld): s361

### s361: array

Höchstens 1000 Textdokumente oder Textobjekte; Metadaten werden lokal zurückgegeben. Bilddokumente werden erkannt, sind auf den konfigurierten reinen Textrouten aber nicht verfügbar und werden nie still verworfen oder heruntergeladen.

{"minItems":"1","maxItems":"1000"}

### s1074: anyOf

Ein Eingabedokument. Beliebige Objektmetadaten bleiben lokal erhalten und werden nie weitergeleitet.

{}

anyOf: s7

### s7: string

{}

anyOf: s1265

### s1265: object

Objekt mit Text und/oder Bild und optionalen Anwendungsmetadaten.

{}

- image (optional): s958

### s958: string

Bild-URL oder Data-URI; wird erkannt, aber von reinen Textadaptern nicht abgerufen.

{}

- text (optional): s959

### s959: string

Dokumenttext, lokal für die Antwort aufbewahrt.

{}

- model (Pflichtfeld): s362

### s362: string

Öffentliche Reranking-Modell-ID oder Alias. Andere Endpunktprotokolle sind nicht zulässig.

{}

```json
"baai/bge-reranker-v2-m3"
```

- provider (optional): s363

### s363: object

Provider-Auswahl, Fallback, Datenbeschränkungen und maximale EUR-Tokenpreise.

{}

- query (Pflichtfeld): s364

### s364: string

Nicht leere Suchanfrage mit höchstens 65536 UTF-8-Bytes.

{}

```json
"European capital"
```

- return_documents (optional): s365

### s365: boolean

Älteres Kompatibilitätsflag; Dokumente werden immer zurückgegeben, wie OpenRouter es verlangt, auch mit `false`.
Strings kommen als Objekte mit einem Feld `text` zurück.

{}

- top_n (optional): s366

### s366: integer

Anzahl der Ergebnisse, von eins bis zur Dokumentzahl (höchstens 1000); Standard sind alle Dokumente. JSON-Ganzzahlen haben kein festes Wire-Format.

{"minimum":"1","maximum":"1000"}

```json
1
```

## Antwort 200: application/json

Geordnete Ergebnisse und exakte EUR-Nutzungsdaten. x-generation-id kennzeichnet die gespeicherte Reranking-Generierung.

```json
{
  "id": "gen-01k7tm9qz3f5c8x2v6b4n0m7hd",
  "model": "baai/bge-reranker-v2-m3",
  "provider": "eu-provider",
  "results": [
    {
      "document": {
        "text": "Paris is in France."
      },
      "index": 0,
      "relevance_score": 0.9
    }
  ],
  "usage": {
    "cost": 0.00005,
    "currency": "EUR",
    "estimated": true,
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}
```

### s31: object

Absteigende Relevanzreihenfolge. Bei gleichen Werten bleibt die ursprüngliche Dokumentreihenfolge erhalten.

{}

```json
{
  "id": "gen-01k7tm9qz3f5c8x2v6b4n0m7hd",
  "model": "baai/bge-reranker-v2-m3",
  "provider": "eu-provider",
  "results": [
    {
      "document": {
        "text": "Paris is in France."
      },
      "index": 0,
      "relevance_score": 0.9
    }
  ],
  "usage": {
    "cost": 0.00005,
    "currency": "EUR",
    "estimated": true,
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}
```

- id (Pflichtfeld): s367

### s367: string

Generierungs-ID des Gateways. Wird auch unter `x-generation-id` zurückgegeben.

{}

```json
"gen-01k7tm9qz3f5c8x2v6b4n0m7hd"
```

- model (Pflichtfeld): s368

### s368: string

Aufgelöste öffentliche Modell-ID.

{}

```json
"baai/bge-reranker-v2-m3"
```

- provider (Pflichtfeld): s369

### s369: string

Konfigurierte Provider-Kennung. Nie beliebiger Upstream-Text.

{}

```json
"eu-provider"
```

- results (Pflichtfeld): s370

### s370: array

Eindeutige ursprüngliche Dokumentindizes, sortiert nach absteigendem endlichem Wert in [0, 1].

{}

### s194: object

Ein bewertetes Dokument.

{}

```json
{
  "document": {
    "text": "Paris is in France."
  },
  "index": 0,
  "relevance_score": 0.9
}
```

- document (Pflichtfeld): s960

### s960: object

Ursprüngliches Dokument als Objekt; Strings werden in ein Feld `text` gepackt. Immer vorhanden.

{}

```json
{
  "text": "Paris is in France."
}
```

- text (Pflichtfeld): s963

### s963: string

Nicht leerer UTF-8-Text mit höchstens 65536 Bytes.

{}

```json
"Paris is in France."
```

- * (optional): s964

### s964: any

Ursprüngliche Metadaten, lokal zurückgegeben, ohne ihren Inhalt auszuwerten oder weiterzugeben.

{}

- index (Pflichtfeld): s961

### s961: integer

Bei null beginnende Position in den übermittelten Dokumenten.

int32

{"minimum":"0"}

```json
0
```

- relevance_score (Pflichtfeld): s962

### s962: number

Endlicher Relevanzwert zwischen null und eins. Dies ist keine Wahrscheinlichkeitsgarantie.

double

{"minimum":"0","maximum":"1"}

```json
0.9
```

- usage (Pflichtfeld): s371

### s371: object

Gemeldete oder ausdrücklich geschätzte Eingabetokens mit exaktem EUR-Betrag.

{}

```json
{
  "cost": 0.00005,
  "currency": "EUR",
  "estimated": true,
  "prompt_tokens": 8,
  "total_tokens": 8
}
```

- cost (Pflichtfeld): s965

### s965: number

Vom Gateway berechneter EUR-Betrag, exakt als JSON-Dezimalzahl dargestellt.

double

{}

```json
0.00005
```

- currency (Pflichtfeld): s966

### s966: string

Immer EUR.

{}

```json
"EUR"
```

- estimated (Pflichtfeld): s967

### s967: boolean

Nur bei einer dokumentierten lokalen Schätzung auf einer Route mit festem Preis true.

{}

- prompt_tokens (Pflichtfeld): s968

### s968: integer

Eingabetokens. Ohne native Nutzungsdaten wird je Paar die Summe aus Suchanfrage- und Dokumentbytes durch vier geteilt.

int64

{"minimum":"0"}

```json
8
```

- total_tokens (Pflichtfeld): s969

### s969: integer

Identisch mit den Eingabetokens. Reranking erzeugt keine Ausgabetokens.

int64

{"minimum":"0"}

```json
8
```

- * (optional): s970

### s970: any

Exakte Kostenbestandteile und weitere Abrechnungsfelder des Gateways.

{}

## Antwort 400: application/json

Erkannte Upstream-Ablehnungen mit 400 oder 422 sind Client-Fehler ohne sinnvollen erneuten Versuch. Ungültiges JSON, ungültige Felder mit gesammelten Issues, unbekanntes Modell oder überschrittene Kontextgrenze.

```json
{
  "error": {
    "code": 400,
    "message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
    "metadata": {
      "docs_url": "/docs#description/model-not-found",
      "issues": [
        {
          "code": "unknown_model",
          "message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
          "path": "$.model"
        }
      ],
      "remedy_hint": "Did you mean deepseek/deepseek-v4.1-flash?",
      "request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
      "retryable": false,
      "type": "model_not_found"
    }
  },
  "user_id": "org_01k7tm2c4e6g8j0k2m4p6r8t0v"
}
```

### s3: object

Jede Antwort mit HTTP-Status ab 400 hat diese Struktur im Fehlerformat von OpenRouter. Alle Gateway-Erweiterungen stehen unter `error.metadata`, damit OpenRouter-Clients keine unbekannte äußere Struktur erhalten. Der Abschnitt „Fehler“ in der Einführung nennt alle Fehlertypen.

{}

```json
{
  "error": {
    "code": 400,
    "message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
    "metadata": {
      "docs_url": "/docs#description/model-not-found",
      "issues": [
        {
          "code": "unknown_model",
          "message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
          "path": "$.model"
        }
      ],
      "remedy_hint": "Did you mean deepseek/deepseek-v4.1-flash?",
      "request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
      "retryable": false,
      "type": "model_not_found"
    }
  },
  "user_id": "org_01k7tm2c4e6g8j0k2m4p6r8t0v"
}
```

- error (Pflichtfeld): s238

### s238: object

Fehlerbeschreibung.

{}

```json
{
  "code": 400,
  "message": "temperature must be at most 2, got 5 (and 1 more)",
  "metadata": {
    "docs_url": "/docs#description/invalid-parameter",
    "issues": [
      {
        "code": "out_of_range",
        "message": "temperature must be at most 2, got 5",
        "path": "$.temperature"
      },
      {
        "code": "invalid_value",
        "message": "messages[1].role must be one of system, developer, user, assistant, tool, got \"bot\"",
        "path": "$.messages[1].role"
      }
    ],
    "request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
    "retryable": false,
    "type": "invalid_parameter"
  }
}
```

- code (Pflichtfeld): s633

### s633: integer

HTTP-Status der Antwort als Zahl.

int32

{"minimum":"0"}

```json
400
```

- message (Pflichtfeld): s634

### s634: string

Fehlerbeschreibung auf Englisch. Bei mehreren Problemen werden das erste und die Anzahl weiterer genannt. Alle stehen unter `metadata.issues`. Der Text kann sich ändern. Im Code stattdessen `metadata.type` auswerten.

{}

```json
"temperature must be at most 2, got 5"
```

- metadata (optional): s635

### s635: object

Maschinenlesbare Details: Fehlertyp, Anfrage-ID, alle Probleme, ein Lösungsvorschlag und bei Provider-Fehlern der betroffene Provider. Bei Gateway-Fehlern immer vorhanden.

{}

```json
{
  "docs_url": "/docs#description/rate-limited",
  "provider_error": {
    "category": "rate_limited",
    "provider_name": "deepinfra",
    "retry_after": 2,
    "retryable": true,
    "status": 429
  },
  "provider_name": "deepinfra",
  "remedy_hint": "Retry after the Retry-After interval, or allow fallbacks to other providers (provider.allow_fallbacks).",
  "request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
  "retry_after": 2,
  "retryable": true,
  "type": "rate_limited"
}
```

- available_providers (optional): s639

### s639: array

Provider, die das Modell anbieten, wenn `provider.only` alle ausgeschlossen hat.

{}

```json
[
  "deepinfra",
  "open-inference"
]
```

- docs_url (Pflichtfeld): s640

### s640: string

Link zum Abschnitt dieses Fehlertyps in der Dokumentation.

{}

```json
"/docs#description/model-not-found"
```

- failed_routing_step (optional): s641

### s641: string

Routing-Schritt, nach dem keine Route übrig blieb. Nur bei Routing-Fehlern.

{}

```json
"Filter by Max Price"
```

- issues (optional): s642

### s642: array

Alle erkannten Probleme der Anfrage, damit sie gemeinsam behoben werden können. Höchstens 20 Einträge. Bei Routing-Fehlern ein Eintrag je ausgeschlossener Route, bei `no_provider_available` einer je fehlgeschlagenem Versuch.

{}

### s123: object

Ein Anfrageproblem, ein Ausschlussgrund einer Route oder ein fehlgeschlagener Versuch.

{}

```json
{
  "code": "invalid_url",
  "message": "messages[2].content[0].image_url.url must be an http(s) URL or a base64 data URL",
  "path": "$.messages[2].content[0].image_url.url"
}
```

- code (Pflichtfeld): s636

### s636: string

Art des Problems. Für Programme stabil.

"required", "invalid_type", "invalid_value", "out_of_range", "empty", "invalid_url", "invalid_base64", "unsupported_media_type", "media_type_mismatch", "media_too_large", "too_many_media", "unsupported_media_transport", "media_fetch_failed", "unknown_tool", "unknown_model", "not_available", "not_allowed", "route_excluded", "bridge_failed", "provider_failed"

{}

```json
"out_of_range"
```

- message (Pflichtfeld): s637

### s637: string

Problembeschreibung auf Englisch mit dem Feld und, sofern kurz, dem gesendeten Wert.

{}

```json
"temperature must be at most 2, got 5"
```

- path (Pflichtfeld): s638

### s638: string

Position des Problems: JSONPath des Felds im Anfrageinhalt, beispielsweise `$.messages[2].content[0].image_url.url`, oder `query.<name>` bei einem Abfrageparameter.

{}

```json
"$.temperature"
```

- provider_error (optional): s643

### s643: oneOf

Sichere Provider-Diagnosen, einheitlich für HTTP-Fehler und finale Stream-Ereignisse.

{}

oneOf: s1158

### s1158: object

Provider-Diagnosen ohne vom Provider verfassten Text. HTTP-Fehler und finale SSE-Fehler verwenden dieselbe Struktur. Beliebige Upstream-Meldungen und Metadaten werden verworfen.

{}

```json
{
  "category": "rate_limited",
  "provider_name": "deepinfra",
  "retry_after": 2,
  "retryable": true,
  "status": 429
}
```

- category (Pflichtfeld): s1299

### s1299: string

Gateway-Klassifizierung anhand von HTTP-Status und erkannten Dialektkennungen.

"rate_limited", "overloaded", "invalid_request", "context_length", "content_filtered", "authentication", "billing", "timeout", "unavailable", "unknown"

{}

```json
"rate_limited"
```

- code (optional): s1300

### s1300: string

Exakte Kennung aus der festen Liste des konfigurierten Dialekts. Beliebige andere Werte werden entfernt.

{}

```json
"rate_limit_exceeded"
```

- provider_name (Pflichtfeld): s1301

### s1301: string

Konfigurierter Provider-Name. Nie ein Name aus dem Upstream-Antwortinhalt.

{}

```json
"deepinfra"
```

- retry_after (optional): s1302

### s1302: integer

Begrenzte Wartezeit in Sekunden aus dem Upstream-Header Retry-After, sofern vorhanden und numerisch.

int64

{"minimum":"0"}

```json
2
```

- retryable (Pflichtfeld): s1303

### s1303: boolean

Ob der klassifizierte Fehler vorübergehend sein kann. Bei unbekannten Fehlern wird ein sinnvoller erneuter Versuch nicht zugesichert.

{}

- status (optional): s1304

### s1304: integer

Tatsächlich vom Upstream empfangener HTTP-Status, einschließlich 200 bei nativen Fehlern. Fehlt, wenn kein HTTP-Status verfügbar ist.

int32

{"minimum":"0"}

```json
429
```

oneOf: s588

### s588: null

{}

- provider_name (optional): s644

### s644: string

Fehlgeschlagener Provider wie im Antwortfeld `provider`. Nur bei Provider-Fehlern.

{}

```json
"deepinfra"
```

- raw (optional): s645

### s645: string

Reserviertes Feld für OpenRouter-Kompatibilität. Das Gateway befüllt es nie. Freier Provider-Text wird bewusst nicht ausgegeben. Stattdessen provider_error verwenden.

{}

```json
""
```

- remedy_hint (optional): s646

### s646: string

Ein konkreter Lösungsvorschlag, beispielsweise die ähnlichste Modell-ID bei einem Tippfehler.

{}

```json
"Did you mean deepseek/deepseek-v4.1-flash?"
```

- request_id (Pflichtfeld): s647

### s647: string

Anfrage-ID. Identisch mit dem Antwortheader `x-request-id`. Diese ID bei Supportanfragen angeben.

{}

```json
"req_01k7tm9qz3f5c8x2v6b4n0m7hd"
```

- requested_providers (optional): s648

### s648: array

Unter `provider.only` genannte Provider, wenn dadurch alle Routen ausgeschlossen wurden.

{}

```json
[
  "scaleway"
]
```

- retry_after (optional): s649

### s649: integer

Wartezeit vor einem erneuten Versuch in Sekunden. Wird bei 429 und 503 auch als Header `Retry-After` gesendet.

int64

{"minimum":"0"}

```json
2
```

- retryable (Pflichtfeld): s650

### s650: boolean

Ob dieselbe unveränderte Anfrage bei einem erneuten Versuch erfolgreich sein kann, beispielsweise nach einer Zeitüberschreitung oder einem Anfragelimit. Im Gegensatz zu Fehlern, die eine geänderte Anfrage erfordern.

{}

- routing_funnel (optional): s651

### s651: array

Eingrenzung der Provider durch das Routing. Jeder Schritt nennt die Anzahl verbleibender Routen. Nur bei Routing-Fehlern, im selben Format wie bei OpenRouter.

{}

### s200: object

Ein Routing-Schritt wie unter `routing_funnel` von OpenRouter.

{}

```json
{
  "endpoint_count": 0,
  "reason": "provider.max_price",
  "step": "Filter by Max Price"
}
```

- endpoint_count (Pflichtfeld): s979

### s979: integer

Anzahl der nach diesem Schritt verbleibenden Routen beziehungsweise Modell-Provider.

{"minimum":"0"}

```json
2
```

- reason (optional): s980

### s980: string

Anfragefeld, nach dem der Schritt gefiltert hat.

{}

```json
"provider.only"
```

- step (Pflichtfeld): s981

### s981: string

Name des Schritts wie bei OpenRouter.

{}

```json
"Initial Endpoints"
```

- type (Pflichtfeld): s652

### s652: string

Stabiler Fehlertyp für die Auswertung im Code. Siehe „Fehler“ in der Einführung. Meldungen können sich ändern, der Typ bleibt stabil.

"invalid_request", "invalid_parameter", "unsupported_parameter", "context_length_exceeded", "authentication", "insufficient_credits", "workspace_budget_exceeded", "permission_denied", "moderation", "model_not_found", "no_endpoint", "not_found", "method_not_allowed", "timeout", "payload_too_large", "media_fetch_failed", "rate_limited", "provider_error", "idempotency_conflict", "idempotency_in_progress", "idempotency_unavailable", "provider_invalid_response", "no_provider_available", "byok_invalid_credential", "byok_rate_limited", "byok_unavailable", "feature_unavailable", "internal"

{}

```json
"invalid_parameter"
```

- user_id (optional): s239

### s239: string | null

Organisation des API-Keys, sofern der Key erkannt wurde.

{}

```json
"org_01k7tm2c4e6g8j0k2m4p6r8t0v"
```

## Antwort 401: application/json

API-Key fehlt, ist ungültig oder abgelaufen.

## Antwort 402: application/json

Guthaben des Keys oder der Organisation reicht für die begrenzte Reservierung nicht aus.

## Antwort 403: application/json

Die Richtlinie der Organisation, des Arbeitsbereichs oder des Schlüssels verbietet dieses Modell

## Antwort 404: application/json

Keine zulässige Reranking-Route. metadata.issues erläutert die ausgeschlossenen Routen.

## Antwort 408: application/json

Zeitüberschreitung beim Hochladen der Anfrage oder bei der Upstream-Antwort

## Antwort 409: application/json

idempotency_conflict: Der Key gehört zu anderem Anfrageinhalt; einen neuen Key verwenden. idempotency_in_progress: Der ursprüngliche Vorgang läuft noch; Retry-After beachten. idempotency_unavailable: Eine sichere Wiederholung ist nicht möglich; nicht still neu berechnen lassen. remedy_hint beachten.

## Antwort 413: application/json

Anfrageinhalt oder geparstes JSON überschreitet die Speichergrenze.

## Antwort 429: application/json

Anfragelimit des Kunden oder Providers erreicht. Retry-After nennt die Wartezeit in Sekunden.

## Antwort 500: application/json

Unerwarteter Gateway-Fehler

## Antwort 501: application/json

feature_unavailable: A required feature is permanently unconfigured on this gateway, for example encrypted idempotency replay without its encryption key, PII redaction without a detector, or BYOK import without import keys. Ask the operator to configure it or remove the optional feature from the request. Retrying the identical request cannot enable the feature: retryable is false and no Retry-After header is sent. Temporary cache, database, detector or provider outages, pending imports and missing or revoked individual customer credentials retain their existing error types.

## Antwort 502: application/json

Sicher aufbereiteter Provider-Fehler oder ungültige Bewertungs- beziehungsweise Nutzungsantwort

## Antwort 503: application/json

Provider fehlgeschlagen, Speicher ausgelastet oder Gateway wird beendet
