# Benchmarks abrufen

Vendor `data` is empty because no licensed vendor-source snapshots are imported.
The separate `lmarena` extension retains published CC BY 4.0 observations, attribution,
source variants, dates, confidence intervals and population sizes. Elo and agent IPS
stay separate. Only canonical models appear here.

Filter by source, arena, category and max_results.
Unavailable sources return an explained empty result.
Unsupported task or benchmark filters appear in x-ignored-params.
Legacy underscore source names are accepted. No API key is required.

`GET https://api.tokenlane.de/v1/benchmarks`

## Authentifizierung

[]

## curl

```curl
curl --request GET \
  --url 'https://api.tokenlane.de/v1/benchmarks'
```

## node

```node
const response = await fetch("https://api.tokenlane.de/v1/benchmarks", {
  method: "GET",
  headers: {
  },
});
console.log(await response.text());
```

## python

```python
import os
import urllib.request

request = urllib.request.Request(
    "https://api.tokenlane.de/v1/benchmarks",
    method="GET",
    headers={
    },
)

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/benchmarks", {
  method: "GET",
  headers: {
  },
});
console.log(await response.text());
```

## Abfrageparameter: source (optional)

lmarena liefert lizenzierte Daten; artificial-analysis, design-arena und openrouter liefern ein leeres Ergebnis mit Begründung

### s7: string

{}

## Abfrageparameter: arena (optional)

Genaue Quell-Arena, etwa text, vision, webdev oder agent; ohne Angabe erscheinen alle Arenen

## Abfrageparameter: category (optional)

Genaue Kategorie der Quelle; ohne Angabe erscheinen alle Kategorien

## Abfrageparameter: max_results (optional)

Positive Höchstzahl der Beobachtungen; ohne Angabe erscheinen alle passenden Werte des begrenzten Datenstands

### s8: integer

{"minimum":"1"}

## Abfrageparameter: task_type (optional)

Wird angenommen, aber nicht ausgewertet und in x-ignored-params genannt: Aufgabenkategorien verschiedener Quellen sind nicht austauschbar

## Abfrageparameter: benchmark_type (optional)

Wird angenommen, aber nicht ausgewertet und in x-ignored-params genannt: OpenRouter-Evaluationen werden nicht importiert

## Antwort 200: application/json

Vendor benchmark envelope and separately attributed licensed LMArena extension

```json
{
  "data": [],
  "lmarena": {
    "data": [
      {
        "arena": "text",
        "as_of": "2026-10-27",
        "category": "overall",
        "display_name": "mock/echo",
        "elo": 1200,
        "elo_lower": 1190,
        "elo_upper": 1210,
        "fetched_at": "2026-10-27T12:00:00Z",
        "metric": "bradley_terry",
        "model_permaslug": "mock/echo",
        "primary_variant": true,
        "rank": 1,
        "rank_of": 100,
        "source": "lmarena",
        "source_name": "synthetic-model",
        "source_row": 0,
        "votes": 12000
      }
    ],
    "meta": {
      "as_of": "2026-10-27T12:00:00Z",
      "citation": "Source: LMArena (lmarena.ai), CC BY 4.0",
      "model_count": 1,
      "note": "Unchanged source observations. Named variants, Elo ratings and agent IPS remain separate.",
      "source": null,
      "source_url": "https://lmarena.ai",
      "task_type": null,
      "version": "v1"
    }
  },
  "meta": {
    "as_of": "",
    "citation": null,
    "model_count": 0,
    "source": null,
    "source_url": null,
    "task_type": null,
    "version": "v1"
  }
}
```

### s9: object

Vendor benchmark envelope plus separately attributed licensed LMArena observations.

{}

- data (Pflichtfeld): s272

### s272: array

Vendor source observations; empty because no corresponding licensed dataset is imported.

{}

### s228: oneOf

The four vendor item forms. This gateway currently imports none of these datasets.

{}

oneOf: s1044

### s1044: object

Artificial Analysis composite indices.

{}

- agentic_index (Pflichtfeld): s1011

### s1011: number | null

Published agentic index, null if unavailable.

double

{}

- coding_index (Pflichtfeld): s1012

### s1012: number | null

Published coding index, null if unavailable.

double

{}

- display_name (Pflichtfeld): s1013

### s1013: string

Source display label.

{}

- intelligence_index (Pflichtfeld): s1014

### s1014: number | null

Published intelligence index, null if unavailable.

double

{}

- model_permaslug (Pflichtfeld): s1015

### s1015: string

Stable model identifier.

{}

- pricing (Pflichtfeld): s1016

### s1016: object | null

Source-published USD prices per input/output token, or null when unavailable. These are benchmark-source metadata, not customer EUR tariffs.

{}

- completion (Pflichtfeld): s1249

### s1249: string

USD price per output token, as an exact decimal string.

{}

- prompt (Pflichtfeld): s1250

### s1250: string

USD price per input token, as an exact decimal string.

{}

- source (Pflichtfeld): s1017

### s1017: string

Exact vendor source.

"artificial-analysis"

{}

oneOf: s1045

### s1045: object

Design Arena tournament observations, not LMArena Elo.

{}

- arena (Pflichtfeld): s619

### s619: string

Arena der Quelle.

{}

- avg_generation_time_ms (Pflichtfeld): s1018

### s1018: number | null

Mean generation time, null when unpublished.

double

{}

- category (Pflichtfeld): s1019

### s1019: string

Source category.

{}

- display_name (Pflichtfeld): s1013

Source display label.

- elo (Pflichtfeld): s621

### s621: number

Elo-Wertung der Quelle.

double

{}

- model_permaslug (Pflichtfeld): s1015

Stable model identifier.

- pricing (Pflichtfeld): s1020

### s1020: object | null

Source-published USD prices per input/output token, or null when unavailable. These are benchmark-source metadata, not customer EUR tariffs.

{}

- completion (Pflichtfeld): s1249

USD price per output token, as an exact decimal string.

- prompt (Pflichtfeld): s1250

USD price per input token, as an exact decimal string.

- source (Pflichtfeld): s1021

### s1021: string

Exact vendor source.

"design-arena"

{}

- tournament_stats (Pflichtfeld): s1022

### s1022: object

Published placement counts.

{}

- first_place (Pflichtfeld): s998

### s998: integer | null

First-place count, null when unpublished.

int64

{}

- fourth_place (Pflichtfeld): s999

### s999: integer | null

Fourth-place count, null when unpublished.

int64

{}

- second_place (Pflichtfeld): s1000

### s1000: integer | null

Second-place count, null when unpublished.

int64

{}

- third_place (Pflichtfeld): s1001

### s1001: integer | null

Third-place count, null when unpublished.

int64

{}

- total (Pflichtfeld): s1002

### s1002: integer | null

Total tournament count, null when unpublished.

int64

{}

- win_rate (Pflichtfeld): s1023

### s1023: number

Win percentage from zero through one hundred.

double

{}

oneOf: s1046

### s1046: object

OpenRouter's classic evaluations.

{}

- accuracy (Pflichtfeld): s1024

### s1024: number

Aggregate accuracy.

double

{}

- accuracy_stddev (Pflichtfeld): s1025

### s1025: number | null

Accuracy standard deviation, null for a single run.

double

{}

- avg_cost_per_task (Pflichtfeld): s1026

### s1026: number | null

Exact USD cost per task, null when unpublished.

double

{}

- benchmark_type (Pflichtfeld): s1027

### s1027: string

Evaluation identifier.

"gpqa_diamond", "tau_bench_verified_airline"

{}

- display_name (Pflichtfeld): s1013

Source display label.

- last_run_timestamp (Pflichtfeld): s1028

### s1028: string

Timestamp of the most recent public run.

{}

- model_permaslug (Pflichtfeld): s1015

Stable model identifier.

- source (Pflichtfeld): s1029

### s1029: string

Exact vendor source.

"openrouter"

{}

- total_tasks (Pflichtfeld): s1030

### s1030: integer

Number of evaluated tasks.

int64

{}

oneOf: s1047

### s1047: object

OpenRouter search evaluations.

{}

- avg_cost_per_task (Pflichtfeld): s1026

Exact USD cost per task, null when unpublished.

- avg_latency_per_task_ms (Pflichtfeld): s1031

### s1031: number | null

Mean latency per task, null when unpublished.

double

{}

- benchmark_type (Pflichtfeld): s1032

### s1032: string

Search evaluation identifier.

"search_browsecomp", "search_hle", "search_dsqa", "search_widesearch"

{}

- display_name (Pflichtfeld): s1013

Source display label.

- last_run_timestamp (Pflichtfeld): s1033

### s1033: string

Timestamp of the newest qualifying run.

{}

- model_permaslug (Pflichtfeld): s1015

Stable model identifier.

- primary_metric (Pflichtfeld): s1034

### s1034: string

Meaning of primary_score.

"accuracy", "f1_by_item"

{}

- primary_score (Pflichtfeld): s1035

### s1035: number

Published headline score.

double

{}

- search_engine (Pflichtfeld): s1036

### s1036: string

Search engine used by the published configuration.

{}

- search_surface (Pflichtfeld): s1037

### s1037: string

Request surface used by the evaluation.

"server-tool", "plugin"

{}

- source (Pflichtfeld): s1038

### s1038: string

Exact vendor source.

"openrouter"

{}

- total_tasks (Pflichtfeld): s1030

Number of evaluated tasks.

- lmarena (Pflichtfeld): s273

### s273: object

Licensed LMArena extension, with its own unchanged metrics and attribution.

{}

- data (Pflichtfeld): s828

### s828: array

Licensed observations in deterministic order, with unchanged source metrics.

{}

### s221: allOf

Ein LMArena-Quellenwert aus dem gemeinsamen Benchmark-Endpunkt.

{}

allOf: s1009

### s1009: allOf

Quellenwert mit unveränderter Messgröße und Teilnehmerbasis.

{}

allOf: s826

### s826: oneOf

Unveränderter Wert, Intervall und Beobachtungszahl in der Messgröße der Quelle.

{}

oneOf: s486

### s486: object

Paarweise menschliche Abstimmungen nach dem Bradley-Terry-Modell der Quelle.

{}

- elo (Pflichtfeld): s1125

### s1125: number

Veröffentlichte Elo-Wertung, unverändert aus der Quelle.

double

{}

```json
1300.5
```

- elo_lower (Pflichtfeld): s1126

### s1126: number

Untere Konfidenzgrenze dieser Wertung.

double

{}

```json
1290
```

- elo_upper (Pflichtfeld): s1127

### s1127: number

Obere Konfidenzgrenze dieser Wertung.

double

{}

```json
1310
```

- metric (Pflichtfeld): s1128

### s1128: string

"bradley_terry"

{}

- votes (Pflichtfeld): s1129

### s1129: integer

Von der Quelle gezählte menschliche Abstimmungen.

int64

{"minimum":"0"}

```json
12000
```

oneOf: s487

### s487: object

IPS-Beobachtungen der Quelle mit eigener Einheit und eigenem Konfidenzintervall.

{}

- metric (Pflichtfeld): s1130

### s1130: string

"ips"

{}

- observations (Pflichtfeld): s1131

### s1131: integer

Von der Quelle gezählte Agenten-Beobachtungen, keine menschlichen Abstimmungen.

int64

{"minimum":"0"}

```json
1200
```

- score (Pflichtfeld): s1132

### s1132: number

Veröffentlichter IPS-Wert; nicht mit Elo-Wertungen vergleichbar.

double

{}

```json
0.75
```

- score_lower (Pflichtfeld): s1133

### s1133: number

Untere Konfidenzgrenze des IPS-Werts.

double

{}

```json
0.7
```

- score_upper (Pflichtfeld): s1134

### s1134: number

Obere Konfidenzgrenze des IPS-Werts.

double

{}

```json
0.8
```

- session_count (optional): s1135

### s1135: integer | null

Anzahl der Sitzungen in der Quelle; fehlt, wenn nicht veröffentlicht.

int64

{"minimum":"0"}

```json
100
```

allOf: s827

### s827: object

{}

- arena (Pflichtfeld): s1185

### s1185: string

Arena der Quelle, etwa text, vision, webdev oder agent.

{}

```json
"text"
```

- as_of (Pflichtfeld): s1186

### s1186: string

Veröffentlichungsdatum dieser Bestenliste im Format JJJJ-MM-TT.

{}

```json
"2026-10-27"
```

- category (Pflichtfeld): s1187

### s1187: string

Kategorie innerhalb der Arena; overall bezeichnet die ungefilterte Bestenliste.

{}

```json
"overall"
```

- fetched_at (Pflichtfeld): s1188

### s1188: string

UTC-Zeitpunkt des Imports des vollständigen Quelldatenstands.

{}

```json
"2026-10-27T12:00:00Z"
```

- primary_variant (optional): s1189

### s1189: boolean

Ob dieser Name der ersten ausdrücklich zugeordneten LMArena-Variante entspricht, die auch der Web-Katalog verwendet.

{}

```json
true
```

- rank (optional): s1190

### s1190: integer | null

Veröffentlichter Rang; null, wenn die Quelle keinen Rang angibt.

int32

{"minimum":"0"}

```json
3
```

- rank_of (Pflichtfeld): s1191

### s1191: integer

Anzahl der Teilnehmer in dieser Quellen-Bestenliste, nicht nur der Modelle dieses Gateways.

int32

{"minimum":"0"}

```json
100
```

- source_name (Pflichtfeld): s1192

### s1192: string

Genaue Modellvariante der Quelle; Varianten werden nicht stillschweigend ersetzt.

{}

```json
"synthetic-model"
```

- source_row (Pflichtfeld): s1193

### s1193: integer

Stabiler Zeilenindex der Quelle innerhalb des importierten Datenstands.

int32

{"minimum":"0"}

```json
1
```

allOf: s1010

### s1010: object

{}

- display_name (Pflichtfeld): s1246

### s1246: string

Kanonische Anzeigebezeichnung; source_name benennt die gemessene Variante.

{}

```json
"mistralai/ministral-8b"
```

- model_permaslug (Pflichtfeld): s1247

### s1247: string

Kanonische Modellkennung ohne Gateway-Aliase.

{}

```json
"mistralai/ministral-8b"
```

- source (Pflichtfeld): s1248

### s1248: string

Quellenkennung lmarena; keine fremde Quelle ohne entsprechende Lizenz.

"lmarena"

{}

- meta (Pflichtfeld): s829

### s829: object

Attribution and result scope, including unavailable-source explanations.

{}

- as_of (Pflichtfeld): s494

### s494: string

Zeitpunkt des letzten vollständigen Imports; leer, wenn kein passender Datenstand vorliegt.

{}

```json
"2026-10-27T12:00:00Z"
```

- citation (Pflichtfeld): s495

### s495: string | null

Vorgeschriebene Quellenangabe; null bei einer angefragten, nicht verfügbaren Quelle.

{}

```json
"Source: LMArena (lmarena.ai), CC BY 4.0"
```

- model_count (Pflichtfeld): s496

### s496: integer

Anzahl verschiedener kanonischer Modelle, die tatsächlich ausgegeben werden.

{"minimum":"0"}

```json
1
```

- note (Pflichtfeld): s497

### s497: string

Begründung für ein leeres Ergebnis oder Erläuterung der Messgrößen.

{}

```json
"Unchanged source observations. Named variants, Elo ratings and agent IPS remain separate."
```

- source (Pflichtfeld): s498

### s498: string | null

Applied source filter for the separately attributed LMArena extension, or null when no source was selected. Unavailable vendor sources retain an explained empty result.

"lmarena", "artificial-analysis", "design-arena", "openrouter", null

{}

- source_url (Pflichtfeld): s499

### s499: string | null

Öffentliche Quellen-URL; null bei einer angefragten, nicht verfügbaren Quelle.

{}

```json
"https://lmarena.ai"
```

- task_type (Pflichtfeld): s500

### s500: string | null

Angewendeter Aufgabenfilter; null, da hier nach Arena und Kategorie gefiltert wird.

{}

- version (Pflichtfeld): s501

### s501: string

Version des öffentlichen Antwortformats.

"v1"

{}

- meta (Pflichtfeld): s274

### s274: object

Vendor result scope, never counting or relabeling LMArena observations.

{}

- as_of (Pflichtfeld): s1048

### s1048: string

Last imported vendor observation timestamp; empty when none is available.

{}

- citation (Pflichtfeld): s1049

### s1049: string | null

Required source attribution, null without an imported vendor dataset.

{}

- model_count (Pflichtfeld): s1050

### s1050: integer

Number of distinct models in data, not in the LMArena extension.

{"minimum":"0"}

- source (Pflichtfeld): s1051

### s1051: string | null

Vendor sources accepted as filters; no data from these sources is imported here.

"artificial-analysis", "design-arena", "openrouter", null

{}

- source_url (Pflichtfeld): s1052

### s1052: string | null

Source URL, null without an imported vendor dataset.

{}

- task_type (Pflichtfeld): s1053

### s1053: string | null

Applied task filter; null when not evaluated.

{}

- version (Pflichtfeld): s1054

### s1054: string

Published vendor response format version.

"v1"

{}

## Antwort 400: application/json

Ungültige oder mehrfach angegebene Benchmark-Parameter

```json
{
  "error": {
    "code": 400,
    "message": "Use a positive integer result limit",
    "metadata": {
      "docs_url": "/docs#description/invalid-parameter",
      "issues": [
        {
          "code": "invalid_value",
          "message": "Use a positive integer result limit",
          "path": "query.max_results"
        }
      ],
      "remedy_hint": "Check the named benchmark query parameters. Elo filters use the curated primary variant; agent IPS is not Elo.",
      "request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
      "retryable": false,
      "type": "invalid_parameter"
    }
  }
}
```

### 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"
```
