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

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

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

// 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.

{
  "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.

{}

{
  "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.

{}

[
  "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.

{}

{
  "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.

{}

"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

{}

100
  • remaining_usd (Pflichtfeld): s788

s788: number

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

double

{}

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

{}

"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

{}

0
  • byok_usage (Pflichtfeld): s795

s795: number

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

double

{}

0
  • byok_usage_daily (Pflichtfeld): s796

s796: number

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

double

{}

0
  • byok_usage_monthly (Pflichtfeld): s797

s797: number

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

double

{}

0
  • byok_usage_weekly (Pflichtfeld): s798

s798: number

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

double

{}

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.

{}

{
  "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

{}

"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.

{}

{
  "limit": 0,
  "remaining": 0,
  "used": 0
}
  • limit (Pflichtfeld): s661

s661: integer

Erlaubte Anfragen an kostenlose Modelle je UTC-Tag.

int64

{}

0
  • remaining (Pflichtfeld): s662

s662: integer

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

int64

{}

0
  • used (Pflichtfeld): s663

s663: integer

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

int64

{}

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.

{}

{
  "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.

{}

{
  "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.

{}

"EUR"
  • remaining_credits (Pflichtfeld): s1319

s1319: string

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

{}

"7"
  • reserved_credits (Pflichtfeld): s1320

s1320: string

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

{}

"1"
  • scope (Pflichtfeld): s1321

s1321: string

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

{}

"cluster"
  • total_credits (Pflichtfeld): s1322

s1322: string

Insgesamt aufgeladener Betrag als exakte Dezimalzeichenkette.

{}

"10"
  • total_usage (Pflichtfeld): s1323

s1323: string

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

{}

"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"}

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"}

60
  • tpm (Pflichtfeld): s957

s957: integer | null

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

int32

{"minimum":"1"}

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.

{}

"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.

{}

"ci-pipeline"
  • limit (Pflichtfeld): s811

s811: number | null

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

double

{}

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

{}

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.

{}

"org_01k7tm2c4e6g8j0k2m4p6r8t0v"
  • rate_limit (Pflichtfeld): s814

s814: object

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

{}

{
  "interval": "10s",
  "note": "This field is deprecated and safe to ignore.",
  "requests": -1
}
  • interval (Pflichtfeld): s820

s820: string

Immer 10s.

{}

"10s"
  • note (Pflichtfeld): s821

s821: string

Immer der Hinweis, dass das Feld veraltet ist.

{}

"This field is deprecated and safe to ignore."
  • requests (Pflichtfeld): s822

s822: integer

Immer -1.

int64

{}

-1
  • usage (Pflichtfeld): s815

s815: number

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

double

{}

0
  • usage_daily (Pflichtfeld): s816

s816: number

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

double

{}

0
  • usage_monthly (Pflichtfeld): s817

s817: number

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

double

{}

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

{}

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.

{}

{
  "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.

{}

{
  "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"}

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.

{}

"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.

{}

{
  "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.

{}

[
  "deepinfra",
  "open-inference"
]

s7: string

{}

  • docs_url (Pflichtfeld): s640

s640: string

Link zum Abschnitt dieses Fehlertyps in der Dokumentation.

{}

"/docs#description/model-not-found"
  • failed_routing_step (optional): s641

s641: string

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

{}

"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.

{}

{
  "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"

{}

"out_of_range"
  • message (Pflichtfeld): s637

s637: string

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

{}

"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.

{}

"$.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.

{}

{
  "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"

{}

"rate_limited"
  • code (optional): s1300

s1300: string

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

{}

"rate_limit_exceeded"
  • provider_name (Pflichtfeld): s1301

s1301: string

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

{}

"deepinfra"
  • retry_after (optional): s1302

s1302: integer

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

int64

{"minimum":"0"}

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"}

429

oneOf: s588

  • provider_name (optional): s644

s644: string

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

{}

"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.

{}

""
  • remedy_hint (optional): s646

s646: string

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

{}

"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.

{}

"req_01k7tm9qz3f5c8x2v6b4n0m7hd"
  • requested_providers (optional): s648

s648: array

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

{}

[
  "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"}

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.

{}

{
  "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"}

2
  • reason (optional): s980

s980: string

Anfragefeld, nach dem der Schritt gefiltert hat.

{}

"provider.only"
  • step (Pflichtfeld): s981

s981: string

Name des Schritts wie bei OpenRouter.

{}

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

{}

"invalid_parameter"
  • user_id (optional): s239

s239: string | null

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

{}

"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)