# Aufrufenden API-Key abrufen

Der verwendete API-Key: Bezeichnung, Ausgabenlimit und Rücksetzintervall, Ausgaben und Ablaufdatum im OpenRouter-Format. Alle Beträge sind EUR, auch Felder mit `*_usd`, deren Namen zur Kompatibilität erhalten bleiben. Nutzung bezeichnet bestätigte Ausgaben über Gateway-Knoten hinweg. Tages-, Wochen- und Monatsfenster verwenden die UTC-Abrechnungszeit; die Woche beginnt montags. `limit_remaining` zieht gleichzeitige Reservierungen ab. `gateway_credits` zeigt für dieselbe Organisation Vorauszahlungen, bestätigte Nutzung und Reservierungen über alle Keys als exakte EUR-Zeichenketten. Neuladen und Prozessneustarts erhalten bestätigte Nutzung im Finanzjournal.

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

## 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 GET \
  --url 'https://api.tokenlane.de/v1/key' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## node

```node
const response = await fetch("https://api.tokenlane.de/v1/key", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
  },
});
console.log(await response.text());
```

## python

```python
import os
import urllib.request

request = urllib.request.Request(
    "https://api.tokenlane.de/v1/key",
    method="GET",
    headers={
        "Authorization": "Bearer " + os.environ["TOKENLANE_API_KEY"],
    },
)

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/key", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
  },
});
console.log(await response.text());
```

## Antwort 200: application/json

Der für die Anfrage verwendete API-Key. Beträge in EUR.

```json
{
  "data": {
    "allowed_data_regions": [
      "europe"
    ],
    "budgets": [
      {
        "budget_id": null,
        "currency": "EUR",
        "guardrail_id": null,
        "include_byok": false,
        "limit_usd": 100,
        "remaining_usd": 100,
        "reset_interval": "weekly",
        "resets_at": "2026-10-26T00:00:00Z",
        "scope": "key_limit",
        "spend_usd": 0
      }
    ],
    "byok_usage": 0,
    "byok_usage_daily": 0,
    "byok_usage_monthly": 0,
    "byok_usage_weekly": 0,
    "creator_user_id": null,
    "effective_budget": {
      "budget_id": null,
      "currency": "EUR",
      "guardrail_id": null,
      "include_byok": false,
      "limit_usd": 100,
      "remaining_usd": 100,
      "reset_interval": "weekly",
      "resets_at": "2026-10-26T00:00:00Z",
      "scope": "key_limit",
      "spend_usd": 0
    },
    "expires_at": "2027-12-31T23:59:59Z",
    "free_model_daily_requests": {
      "limit": 0,
      "remaining": 0,
      "used": 0
    },
    "gateway_rate_limits": {
      "effective": {
        "max_parallel_requests": 4,
        "rpm": 60,
        "tpm": 10000
      },
      "key": {
        "max_parallel_requests": 4,
        "rpm": 60,
        "tpm": 10000
      },
      "organization": {
        "max_parallel_requests": null,
        "rpm": null,
        "tpm": null
      },
      "scope": "cluster"
    },
    "include_byok_in_limit": false,
    "is_free_tier": false,
    "is_management_key": false,
    "is_provisioning_key": false,
    "label": "ci-pipeline",
    "limit": 100,
    "limit_remaining": 100,
    "limit_reset": "weekly",
    "organization_id": "org_01k7tm2c4e6g8j0k2m4p6r8t0v",
    "rate_limit": {
      "interval": "10s",
      "note": "This field is deprecated and safe to ignore.",
      "requests": -1
    },
    "usage": 0,
    "usage_daily": 0,
    "usage_monthly": 0,
    "usage_weekly": 0,
    "workspace_id": null
  }
}
```

### s19: object

Antwort von `GET /v1/key` in der OpenRouter-Struktur.

{}

- data (Pflichtfeld): s308

### s308: object

Der für die Anfrage verwendete API-Key.

{}

```json
{
  "allowed_data_regions": [
    "europe"
  ],
  "budgets": [
    {
      "budget_id": null,
      "currency": "EUR",
      "guardrail_id": null,
      "include_byok": false,
      "limit_usd": 100,
      "remaining_usd": 100,
      "reset_interval": "weekly",
      "resets_at": "2026-10-26T00:00:00Z",
      "scope": "key_limit",
      "spend_usd": 0
    }
  ],
  "byok_usage": 0,
  "byok_usage_daily": 0,
  "byok_usage_monthly": 0,
  "byok_usage_weekly": 0,
  "creator_user_id": null,
  "effective_budget": {
    "budget_id": null,
    "currency": "EUR",
    "guardrail_id": null,
    "include_byok": false,
    "limit_usd": 100,
    "remaining_usd": 100,
    "reset_interval": "weekly",
    "resets_at": "2026-10-26T00:00:00Z",
    "scope": "key_limit",
    "spend_usd": 0
  },
  "expires_at": "2027-12-31T23:59:59Z",
  "free_model_daily_requests": {
    "limit": 0,
    "remaining": 0,
    "used": 0
  },
  "gateway_rate_limits": {
    "effective": {
      "max_parallel_requests": 4,
      "rpm": 60,
      "tpm": 10000
    },
    "key": {
      "max_parallel_requests": 4,
      "rpm": 60,
      "tpm": 10000
    },
    "organization": {
      "max_parallel_requests": null,
      "rpm": null,
      "tpm": null
    },
    "scope": "cluster"
  },
  "include_byok_in_limit": false,
  "is_free_tier": false,
  "is_management_key": false,
  "is_provisioning_key": false,
  "label": "ci-pipeline",
  "limit": 100,
  "limit_remaining": 100,
  "limit_reset": "weekly",
  "organization_id": "org_01k7tm2c4e6g8j0k2m4p6r8t0v",
  "rate_limit": {
    "interval": "10s",
    "note": "This field is deprecated and safe to ignore.",
    "requests": -1
  },
  "usage": 0,
  "usage_daily": 0,
  "usage_monthly": 0,
  "usage_weekly": 0,
  "workspace_id": null
}
```

- allowed_data_regions (Pflichtfeld): s793

### s793: array

Regionseinstellung der wirksamen Compliance-Policy: global ohne Mindestanforderung an die Compliance, sonst europe. Bei der Routenauswahl gelten zusätzlich die übrigen Policy-Einschränkungen.

{}

```json
[
  "europe"
]
```

### s98: string

Compliance regions represented by the gateway's effective policy and generation metadata.

"global", "europe"

{}

- budgets (Pflichtfeld): s794

### s794: array

Alle für den Schlüssel geltenden Budgets in der Reihenfolge ihrer Prüfung: zuerst das
Arbeitsbereichsbudget (`workspace`), dann das eigene Limit des Schlüssels (`key_limit`). Ohne
Budget leer. Das vorausbezahlte Organisationsguthaben heißt `gateway_credits`.

{}

### s144: object

Ein für den Key geltendes Budget mit den darauf angerechneten Ausgaben. Beträge sind trotz des aus OpenRouter-Kompatibilität beibehaltenen Suffixes `_usd` in **EUR** angegeben.

{}

```json
{
  "budget_id": null,
  "currency": "EUR",
  "guardrail_id": null,
  "include_byok": false,
  "limit_usd": 100,
  "remaining_usd": 100,
  "reset_interval": "weekly",
  "resets_at": "2026-10-26T00:00:00Z",
  "scope": "key_limit",
  "spend_usd": 0
}
```

- budget_id (Pflichtfeld): s783

### s783: string | null

ID des Arbeitsbereichs (`ws_…`) für das `workspace`-Budget; null bei `key_limit`.

{}

- currency (Pflichtfeld): s784

### s784: string

Currency of limit_usd, spend_usd and remaining_usd. Always EUR; the suffixes are compatibility names.

{}

```json
"EUR"
```

- guardrail_id (Pflichtfeld): s785

### s785: string | null

ID der Schutzregel, zu der dieses Budget gehört. Bei `key_limit` null.

{}

- include_byok (Pflichtfeld): s786

### s786: boolean

Ob Ausgaben über eigene Provider-Keys (BYOK) auf dieses Budget angerechnet werden. Immer false.

{}

- limit_usd (Pflichtfeld): s787

### s787: number

EUR-Limit für das aktuelle Zeitfenster.

double

{}

```json
100
```

- remaining_usd (Pflichtfeld): s788

### s788: number

Nach bestätigten Ausgaben und offenen Reservierungen verfügbare EUR. Nie kleiner als null.

double

{}

```json
100
```

- reset_interval (Pflichtfeld): s789

### s789: string | null

UTC reset window of a key or workspace budget; absence denotes a lifetime budget.

"daily", "weekly", "monthly", null

{}

- resets_at (Pflichtfeld): s790

### s790: string | null

UTC-Zeitpunkt nach RFC 3339, an dem das Zeitfenster neu beginnt. Bei einem Budget über die gesamte Laufzeit null.

date-time

{}

```json
"2026-10-26T00:00:00Z"
```

- scope (Pflichtfeld): s791

### s791: string

Art des Budgets: `workspace` ist das gemeinsame Budget des Arbeitsbereichs des Schlüssels,
`key_limit` dessen eigenes Limit. Beide müssen Spielraum für eine Anfrage haben.

"workspace", "key_limit"

{}

- spend_usd (Pflichtfeld): s792

### s792: number

Ausgaben in EUR, die im aktuellen Zeitfenster gegen das Limit zählen. Über alle Gateway-Knoten bestätigt.

double

{}

```json
0
```

- byok_usage (Pflichtfeld): s795

### s795: number

EUR-Ausgaben über eigene Provider-Keys (BYOK). Immer 0, da das Gateway kein BYOK anbietet.

double

{}

```json
0
```

- byok_usage_daily (Pflichtfeld): s796

### s796: number

BYOK-Ausgaben in EUR am aktuellen UTC-Tag. Immer 0.

double

{}

```json
0
```

- byok_usage_monthly (Pflichtfeld): s797

### s797: number

BYOK-Ausgaben in EUR im aktuellen UTC-Monat. Immer 0.

double

{}

```json
0
```

- byok_usage_weekly (Pflichtfeld): s798

### s798: number

BYOK-Ausgaben in EUR in der aktuellen UTC-Woche. Immer 0.

double

{}

```json
0
```

- creator_user_id (Pflichtfeld): s799

### s799: string | null

Member who created the key, or null when the inference snapshot has no creator identity.
The gateway does not substitute the owning organization for an unknown member.

{}

- effective_budget (Pflichtfeld): s800

### s800: object | null

Ein für den Key geltendes Budget mit den darauf angerechneten Ausgaben. Beträge sind trotz des aus OpenRouter-Kompatibilität beibehaltenen Suffixes `_usd` in **EUR** angegeben.

{}

```json
{
  "budget_id": null,
  "currency": "EUR",
  "guardrail_id": null,
  "include_byok": false,
  "limit_usd": 100,
  "remaining_usd": 100,
  "reset_interval": "weekly",
  "resets_at": "2026-10-26T00:00:00Z",
  "scope": "key_limit",
  "spend_usd": 0
}
```

- budget_id (Pflichtfeld): s783

ID des Arbeitsbereichs (`ws_…`) für das `workspace`-Budget; null bei `key_limit`.

- currency (Pflichtfeld): s784

Currency of limit_usd, spend_usd and remaining_usd. Always EUR; the suffixes are compatibility names.

- guardrail_id (Pflichtfeld): s785

ID der Schutzregel, zu der dieses Budget gehört. Bei `key_limit` null.

- include_byok (Pflichtfeld): s786

Ob Ausgaben über eigene Provider-Keys (BYOK) auf dieses Budget angerechnet werden. Immer false.

- limit_usd (Pflichtfeld): s787

EUR-Limit für das aktuelle Zeitfenster.

- remaining_usd (Pflichtfeld): s788

Nach bestätigten Ausgaben und offenen Reservierungen verfügbare EUR. Nie kleiner als null.

- reset_interval (Pflichtfeld): s789

UTC reset window of a key or workspace budget; absence denotes a lifetime budget.

- resets_at (Pflichtfeld): s790

UTC-Zeitpunkt nach RFC 3339, an dem das Zeitfenster neu beginnt. Bei einem Budget über die gesamte Laufzeit null.

- scope (Pflichtfeld): s1181

### s1181: string

Art des Budgets: `workspace` ist das gemeinsame Budget des Arbeitsbereichs des Schlüssels,
`key_limit` dessen eigenes Limit. Beide müssen Spielraum für eine Anfrage haben.

"workspace", "key_limit"

{}

- spend_usd (Pflichtfeld): s792

Ausgaben in EUR, die im aktuellen Zeitfenster gegen das Limit zählen. Über alle Gateway-Knoten bestätigt.

- expires_at (optional): s801

### s801: string | null

Ab diesem Zeitpunkt (RFC 3339, UTC) scheitern Anfragen mit dem Key mit 401 `authentication`. Null, wenn der Key nicht abläuft. Ein bereits laufender Stream wird abgeschlossen.

date-time

{}

```json
"2027-12-31T23:59:59Z"
```

- free_model_daily_requests (Pflichtfeld): s802

### s802: object

Tageskontingent für kostenlose Modellvarianten (`:free` bei OpenRouter). Das Gateway hat kein solches Kontingent. Alle Zähler sind deshalb 0.

{}

```json
{
  "limit": 0,
  "remaining": 0,
  "used": 0
}
```

- limit (Pflichtfeld): s661

### s661: integer

Erlaubte Anfragen an kostenlose Modelle je UTC-Tag.

int64

{}

```json
0
```

- remaining (Pflichtfeld): s662

### s662: integer

Heute noch verfügbare Anfragen an kostenlose Modelle (UTC).

int64

{}

```json
0
```

- used (Pflichtfeld): s663

### s663: integer

Heute ausgeführte Anfragen an kostenlose Modelle (UTC).

int64

{}

```json
0
```

- gateway_byok_quota (optional): s803

### s803: oneOf

Current allowance and endpoint resources shared by all organizations of this identity.
Byte counters include in-flight reservations; unknown outcomes retain coverage.

{}

oneOf: s1182

### s1182: object

Current shared customer-identity quota, read from the authoritative financial journal.

{}

```json
{
  "day_bytes": 100,
  "day_limit": 1073741824,
  "free_limit": 100000,
  "free_remaining": 99990,
  "free_used": 10,
  "month": "2026-11",
  "month_bytes": 100,
  "month_limit": 10737418240,
  "parallel": 0,
  "parallel_limit": 8
}
```

- day_bytes (Pflichtfeld): s1308

### s1308: integer

Rolling transfer debt including active reservations and their bounded expiry margin.

int64

{"minimum":"0"}

- day_limit (Pflichtfeld): s1309

### s1309: integer

Operator-approved rolling 24-hour endpoint transfer limit, default 1 GiB.

int64

{"minimum":"0"}

- free_limit (Pflichtfeld): s1310

### s1310: integer

Current configured free allowance.

int64

{"minimum":"0"}

- free_remaining (Pflichtfeld): s1311

### s1311: integer

Free requests currently available; never a historical request ordinal.

int64

{"minimum":"0"}

- free_used (Pflichtfeld): s1312

### s1312: integer

Consumed and reserved free requests across all organizations of the identity.

int64

{"minimum":"0"}

- month (Pflichtfeld): s1313

### s1313: string

UTC calendar month, YYYY-MM.

{}

- month_bytes (Pflichtfeld): s1314

### s1314: integer

Decoded application bytes and active reservations in this UTC month.

int64

{"minimum":"0"}

- month_limit (Pflichtfeld): s1315

### s1315: integer

Operator-approved monthly endpoint transfer limit, default 10 GiB.

int64

{"minimum":"0"}

- parallel (Pflichtfeld): s1316

### s1316: integer

Endpoint requests with unexpired parallelism reservations.

int64

{"minimum":"0"}

- parallel_limit (Pflichtfeld): s1317

### s1317: integer

Operator-approved concurrent endpoint request limit, default eight.

int64

{"minimum":"0"}

oneOf: s588

### s588: null

{}

- gateway_credits (optional): s804

### s804: oneOf

Gateway-Erweiterung: vorausbezahltes Organisationskonto über alle Gateway-Knoten. Fehlt, wenn Vorauszahlung nie konfiguriert wurde. Bestätigte Nutzung bleibt bei Neustarts erhalten.

{}

oneOf: s1183

### s1183: object

Exakte vorausbezahlte Beträge, die alle Keys der angemeldeten Organisation gemeinsam nutzen.

{}

```json
{
  "currency": "EUR",
  "remaining_credits": "7",
  "reserved_credits": "1",
  "scope": "cluster",
  "total_credits": "10",
  "total_usage": "2"
}
```

- currency (Pflichtfeld): s1318

### s1318: string

Währung aller Beträge. Immer EUR.

{}

```json
"EUR"
```

- remaining_credits (Pflichtfeld): s1319

### s1319: string

Verfügbares Guthaben nach Nutzung und Reservierungen. Nie kleiner als null.

{}

```json
"7"
```

- reserved_credits (Pflichtfeld): s1320

### s1320: string

Offene Reservierungen einschließlich Anfragen mit fehlenden abschließenden Nutzungsdaten.

{}

```json
"1"
```

- scope (Pflichtfeld): s1321

### s1321: string

Geltungsbereich. Alle Gateway-Knoten teilen diese vorausbezahlten Beträge.

{}

```json
"cluster"
```

- total_credits (Pflichtfeld): s1322

### s1322: string

Insgesamt aufgeladener Betrag als exakte Dezimalzeichenkette.

{}

```json
"10"
```

- total_usage (Pflichtfeld): s1323

### s1323: string

Bestätigte Nutzung aller Keys der Organisation als exakte Dezimalzeichenkette.

{}

```json
"2"
```

oneOf: s588

- gateway_rate_limits (optional): s805

### s805: oneOf

Gateway-Erweiterung: konfigurierte Clusterquoten, unabhängig vom veralteten `rate_limit`. Organisationsquoten gelten gemeinsam für alle ihre Keys und Gateway-Knoten.

{}

oneOf: s1184

### s1184: object

Clusterweite Kundenquoten. Beide Geltungsbereiche müssen eine Anfrage zulassen; keiner ersetzt den anderen.

{}

- effective (Pflichtfeld): s1324

### s1324: object

Je Dimension die kleinere konfigurierte Grenze. Gemeinsam genutzte Kontingente können früher erschöpft sein.

{}

- max_parallel_requests (Pflichtfeld): s955

### s955: integer | null

Gleichzeitige Anfragen. Offene Streams belegen bis zum Abschluss oder Abbruch einen Platz.

int32

{"minimum":"1"}

```json
4
```

- rpm (Pflichtfeld): s956

### s956: integer | null

Anfragen je Minute mit einer kurzzeitigen Spitze bis zu dieser Anzahl. Authentifizierte Lesezugriffe zählen ebenfalls.

int32

{"minimum":"1"}

```json
60
```

- tpm (Pflichtfeld): s957

### s957: integer | null

Prompt- und Ausgabetokens je Minute einschließlich Schätzungen laufender Anfragen.

int32

{"minimum":"1"}

```json
10000
```

- key (Pflichtfeld): s1325

### s1325: object

Für diesen API-Key konfigurierte Kontingente.

{}

- max_parallel_requests (Pflichtfeld): s955

Gleichzeitige Anfragen. Offene Streams belegen bis zum Abschluss oder Abbruch einen Platz.

- rpm (Pflichtfeld): s956

Anfragen je Minute mit einer kurzzeitigen Spitze bis zu dieser Anzahl. Authentifizierte Lesezugriffe zählen ebenfalls.

- tpm (Pflichtfeld): s957

Prompt- und Ausgabetokens je Minute einschließlich Schätzungen laufender Anfragen.

- organization (Pflichtfeld): s1326

### s1326: object

Von allen Keys der Organisation gemeinsam genutzte Kontingente.

{}

- max_parallel_requests (Pflichtfeld): s955

Gleichzeitige Anfragen. Offene Streams belegen bis zum Abschluss oder Abbruch einen Platz.

- rpm (Pflichtfeld): s956

Anfragen je Minute mit einer kurzzeitigen Spitze bis zu dieser Anzahl. Authentifizierte Lesezugriffe zählen ebenfalls.

- tpm (Pflichtfeld): s957

Prompt- und Ausgabetokens je Minute einschließlich Schätzungen laufender Anfragen.

- scope (Pflichtfeld): s1327

### s1327: string

Geltungsbereich: `cluster`. Alle Gateway-Knoten teilen diese Zähler.

{}

```json
"cluster"
```

oneOf: s588

- include_byok_in_limit (Pflichtfeld): s806

### s806: boolean

Ob Ausgaben über eigene Provider-Keys (BYOK) auf das Limit angerechnet werden. Immer false, da das Gateway kein BYOK anbietet.

{}

- is_free_tier (Pflichtfeld): s807

### s807: boolean

Ob der Key zu einer kostenlosen Stufe gehört. Immer false, da es keine kostenlose Stufe gibt.

{}

- is_management_key (Pflichtfeld): s808

### s808: boolean

Always false for inference keys. Organization management keys authorize only the separate
control-plane API and are excluded from the gateway inference snapshot.

{}

- is_provisioning_key (Pflichtfeld): s809

### s809: boolean

Veralteter Alias von `is_management_key`.

{"deprecated":"true"}

- label (Pflichtfeld): s810

### s810: string

Beim Erstellen festgelegter Key-Name.

{}

```json
"ci-pipeline"
```

- limit (Pflichtfeld): s811

### s811: number | null

Maximale EUR-Ausgaben des Keys je Zeitfenster `limit_reset` oder insgesamt. Ohne Limit null.

double

{}

```json
100
```

- limit_remaining (Pflichtfeld): s812

### s812: number | null

EUR, die der Key nach bestätigten Kosten und offenen Reservierungen im aktuellen Zeitfenster noch ausgeben darf. Ohne Limit null.

double

{}

```json
100
```

- limit_reset (Pflichtfeld): s789

UTC reset window of a key or workspace budget; absence denotes a lifetime budget.

- organization_id (Pflichtfeld): s813

### s813: string | null

Organisation des Keys. Steht bei Fehlerantworten auch unter `user_id`.

{}

```json
"org_01k7tm2c4e6g8j0k2m4p6r8t0v"
```

- rate_limit (Pflichtfeld): s814

### s814: object

Bei OpenRouter veraltet und nur aus Kompatibilitätsgründen vorhanden. Feste Werte, die ignoriert werden sollten.

{}

```json
{
  "interval": "10s",
  "note": "This field is deprecated and safe to ignore.",
  "requests": -1
}
```

- interval (Pflichtfeld): s820

### s820: string

Immer `10s`.

{}

```json
"10s"
```

- note (Pflichtfeld): s821

### s821: string

Immer der Hinweis, dass das Feld veraltet ist.

{}

```json
"This field is deprecated and safe to ignore."
```

- requests (Pflichtfeld): s822

### s822: integer

Immer -1.

int64

{}

```json
-1
```

- usage (Pflichtfeld): s815

### s815: number

Gesamtausgaben des Keys in EUR. Über alle Gateway-Knoten bestätigt.

double

{}

```json
0
```

- usage_daily (Pflichtfeld): s816

### s816: number

Ausgaben in EUR am aktuellen UTC-Tag. Über alle Gateway-Knoten bestätigt.

double

{}

```json
0
```

- usage_monthly (Pflichtfeld): s817

### s817: number

Ausgaben in EUR im aktuellen UTC-Monat. Über alle Gateway-Knoten bestätigt.

double

{}

```json
0
```

- usage_weekly (Pflichtfeld): s818

### s818: number

Ausgaben in EUR in der aktuellen UTC-Woche von Montag bis Sonntag. Über alle Gateway-Knoten bestätigt.

double

{}

```json
0
```

- workspace_id (Pflichtfeld): s819

### s819: string | null

Actual workspace the key belongs to (`ws_…`), or null without a workspace assignment.
Workspace membership is independent of whether the workspace has a spending limit.

{}

## Antwort 401: application/json

API-Key fehlt, ist ungültig oder abgelaufen (`authentication`).

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

### s7: string

{}

- 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

- 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 429: application/json

Kundenkontingent erschöpft (`rate_limited`). Nach der in Retry-After angegebenen Wartezeit erneut versuchen.

## Antwort 500: application/json

Unerwarteter Gateway-Fehler (`internal`)

## Antwort 503: application/json

Shared customer admission or identity quota unavailable; retry shortly (`no_provider_available` or `byok_unavailable`)
