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)