Metadaten einer Generierung abrufen
Model, provider, token counts, cost in EUR, timing and how the generation ended, in OpenRouter's format. Never the prompt or the answer. The ID is the id of a chat completion or its x-generation-id header. A generation can be looked up as soon as its answer is complete; streams that failed or that the client cancelled are recorded too. preprocessing[] retains the same OCR bridge entries shown in Chat usage.cost_details.bridges: id=file-parser, model, provider, unit=page, quantity and exact EUR cost_pico_eur. These charges are already included once in total_cost; do not add them again.
Only keys of the same organization and workspace that created a generation see it; for every other key it does not exist. With durable usage export configured, older generations are read from the local spool or shared Postgres store. Other nodes see them after asynchronous export; retry a not-yet-visible receipt. Database outages return 503 on cache misses.
GET https://api.tokenlane.de/v1/generation
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": [] } ] ]
Werte mit YOUR_ sind Platzhalter. Vor dem Senden durch passende eigene Werte ersetzen.
curl
curl --request GET \
--url 'https://api.tokenlane.de/v1/generation?id=YOUR_ID' \
--header 'Authorization: Bearer YOUR_API_KEY'
node
const response = await fetch("https://api.tokenlane.de/v1/generation?id=YOUR_ID", {
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/generation?id=YOUR_ID",
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/generation?id=YOUR_ID", {
method: "GET",
headers: {
"Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
},
});
console.log(await response.text());
Abfrageparameter: id (Pflichtfeld)
Generierungs-ID, beispielsweise die id einer Chatantwort
s7: string
{}
Antwort 200: application/json
Metadaten der Generierung. Beträge in EUR.
{
"data": {
"api_type": "completions",
"app_id": null,
"cache_discount": null,
"cancelled": false,
"created_at": "2026-10-19T08:15:42.118Z",
"currency": "EUR",
"data_region": "europe",
"error_type": null,
"external_user": null,
"finish_reason": "stop",
"first_byte_latency": 310,
"gateway_overhead": 0.412,
"generation_time": 1180,
"http_referer": null,
"id": "gen-01k7tm9qz3f5c8x2v6b4n0m7hd",
"is_byok": false,
"latency": 1250,
"model": "deepseek/deepseek-v4.1-flash",
"moderation_latency": null,
"native_finish_reason": "stop",
"native_tokens_cached": 0,
"native_tokens_completion": 25,
"native_tokens_completion_images": null,
"native_tokens_prompt": 10,
"native_tokens_reasoning": 5,
"num_fetches": null,
"num_input_audio_prompt": null,
"num_media_completion": null,
"num_media_prompt": null,
"num_search_results": null,
"num_web_searches": 0,
"ocr_cost": 0,
"origin": "",
"original": null,
"parent_id": null,
"preset_id": null,
"provider_name": "scaleway",
"provider_responses": null,
"queue_time": 0,
"request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
"requested_model": "eu/fast",
"router": "eu/fast",
"service_tier": null,
"session_id": null,
"streamed": true,
"timings": {
"auth": 0.081,
"body": 0.034,
"post": 0.079,
"queue": 0,
"routing": 0.096,
"streaming": 940.374,
"total": 1250,
"upstream": 309.214,
"validate": 0.122
},
"tokens_completion": 25,
"tokens_prompt": 10,
"total_cost": 0.000021,
"upstream_id": "chatcmpl-791bcf62-080e-4568-87d0-94c72e3b4946",
"upstream_inference_cost": 0.000021,
"usage": 0.000021,
"user_agent": null,
"web_search_engine": null,
"workspace_id": "org_01k7tm2c4e6g8j0k2m4p6r8t0v"
}
}
s16: object
Antwort von GET /v1/generation in der OpenRouter-Struktur.
{}
- data (Pflichtfeld): s305
s305: object
Die Generierung.
{}
{
"api_type": "completions",
"app_id": null,
"cache_discount": null,
"cancelled": false,
"created_at": "2026-10-19T08:15:42.118Z",
"currency": "EUR",
"data_region": "europe",
"error_type": null,
"external_user": null,
"finish_reason": "stop",
"first_byte_latency": 310,
"gateway_overhead": 0.412,
"generation_time": 1180,
"http_referer": null,
"id": "gen-01k7tm9qz3f5c8x2v6b4n0m7hd",
"is_byok": false,
"latency": 1250,
"model": "deepseek/deepseek-v4.1-flash",
"moderation_latency": null,
"native_finish_reason": "stop",
"native_tokens_cached": 0,
"native_tokens_completion": 25,
"native_tokens_completion_images": null,
"native_tokens_prompt": 10,
"native_tokens_reasoning": 5,
"num_fetches": null,
"num_input_audio_prompt": null,
"num_media_completion": null,
"num_media_prompt": null,
"num_search_results": null,
"num_web_searches": 0,
"ocr_cost": 0,
"origin": "",
"original": null,
"parent_id": null,
"preset_id": null,
"provider_name": "scaleway",
"provider_responses": null,
"queue_time": 0,
"request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
"requested_model": "eu/fast",
"router": "eu/fast",
"service_tier": null,
"session_id": null,
"streamed": true,
"timings": {
"auth": 0.081,
"body": 0.034,
"post": 0.079,
"queue": 0,
"routing": 0.096,
"streaming": 940.374,
"total": 1250,
"upstream": 309.214,
"validate": 0.122
},
"tokens_completion": 25,
"tokens_prompt": 10,
"total_cost": 0.000021,
"upstream_id": "chatcmpl-791bcf62-080e-4568-87d0-94c72e3b4946",
"upstream_inference_cost": 0.000021,
"usage": 0.000021,
"user_agent": null,
"web_search_engine": null,
"workspace_id": "org_01k7tm2c4e6g8j0k2m4p6r8t0v"
}
- api_type (Pflichtfeld): s694
s694: string | null
Which API created the generation: completions for chat completions, responses for the Responses API, embeddings for embeddings, stt for audio transcriptions, rerank for document ranking, and decisions for structured decisions.
{}
"completions"
- app_id (Pflichtfeld): s695
s695: integer | null
ID der anfragenden Anwendung. Immer null, da Anwendungen nicht erfasst werden.
int64
{}
- app_title (optional): s696
s696: string | null
Vom Aufrufer angegebener Anwendungsname (X-OpenRouter-Title, danach X-Title) oder null.
{}
"Example client"
- attribution_truncated (optional): s697
s697: boolean
Die Zuordnungsdaten überschritten ihr Textbudget von 4096 Bytes oder das prozessweite Speicherbudget von 16 MiB. Felder können gekürzt werden oder fehlen; Abrechnungsdaten bleiben vollständig erhalten.
{}
false
- byok_fallback (optional): s698
s698: boolean | null
An authorized fallback from a customer credential to platform credit occurred.
{}
true
- byok_fee (optional): s699
s699: object
Tokenlane's service fee for requests that used the organization's own provider credentials (not part of OpenRouter's format); absent for platform-funded requests.
{}
{
"estimated_tokens": 0,
"fee": 0.00005,
"free": false,
"free_requests": 100000,
"reported_tokens": 1480,
"request_number": 100001,
"tokens": 1480
}
- estimated_tokens (Pflichtfeld): s502
s502: integer
The part of tokens estimated by the gateway.
int64
{"minimum":"0"}
0
- fee (Pflichtfeld): s503
s503: number
The fee debited for this request. The monthly total of billable tokens is rounded down to whole thousands, so a single request can be charged less than its tokens imply.
double
{}
0.00005
- free (Pflichtfeld): s504
s504: boolean
Whether the request was inside the free allowance.
{}
- free_requests (Pflichtfeld): s505
s505: integer
Free requests per customer identity and month.
int64
{"minimum":"0"}
100000
- reported_tokens (Pflichtfeld): s506
s506: integer
The part of tokens taken from the provider's reported usage.
int64
{"minimum":"0"}
1480
- request_number (Pflichtfeld): s507
s507: integer
One-based number of this request within the customer identity's UTC calendar month.
int64
{"minimum":"0"}
100001
- tokens (Pflichtfeld): s508
s508: integer
Tokens counted for this request: the provider's usage for curated providers, the gateway's own deterministic estimate for customer-defined endpoints.
int64
{"minimum":"0"}
1480
- byok_fee_pending (optional): s700
s700: boolean | null
The service fee is awaiting the same durable financial operation as its reservation. While true, total_cost includes only confirmed base charges, not an assumed zero fee.
{}
true
- cache_discount (Pflichtfeld): s701
s701: number | null
Nachlass durch Prompt-Caching. Immer null, da nicht berechnet.
double
{}
- cancelled (Pflichtfeld): s702
s702: boolean | null
Ob der Client die Verbindung vor Abschluss der Antwort geschlossen hat.
{}
false
- cost_details (Pflichtfeld): s703
s703: object | null
Überschneidungsfreie Geldpositionen in der angegebenen Währung. Ihre exakte Summe ergibt die Kosten. Aggregierte Felder wie upstream_inference_cost dürfen nicht erneut hinzugefügt werden.
{}
{
"cache_read_cost": 0.000001,
"cache_write_cost": 0,
"completion_cost": 0.00002,
"currency": "EUR",
"media_cost": 0,
"ocr_cost": 0,
"prompt_cost": 0.00001,
"reasoning_cost": 0,
"request_cost": 0.001,
"server_tool_cost": 0
}
- cache_read_cost (Pflichtfeld): s572
s572: number
Aus dem Cache gelesene Eingabetokens, einschließlich zwischengespeicherten Audios.
double
{}
0.00001
- cache_write_cost (Pflichtfeld): s573
s573: number
In den Cache geschriebene Eingabetokens, einschließlich verlängerter Speicherfristen.
double
{}
0.00001
- completion_cost (Pflichtfeld): s574
s574: number
Reguläre Ausgabetokens ohne Begründungs- und Audiotokens.
double
{}
0.00001
- currency (Pflichtfeld): s575
s575: string
ISO-4217-Währung aller Einzelpositionen. EUR bei Kundenkosten.
{}
"EUR"
- media_cost (Pflichtfeld): s576
s576: number
Eingabe- und Ausgabemedientokens, Bildgebühren und transkribierte Sekunden.
double
{}
0.00001
- ocr_cost (Pflichtfeld): s577
s577: number
Gemeinsame OCR-Vorverarbeitung. Wird einmal je Generierung und für Provider-Kosten mit 0 berechnet.
double
{}
0.00001
- pii_cost (optional): s578
s578: number | null
Gemeinsame EUR-Kosten der Erkennung personenbezogener Daten, einmalig in der Kundengesamtsumme enthalten.
double
{}
0.000002
- prompt_cost (Pflichtfeld): s579
s579: number
Nicht zwischengespeicherte reguläre Eingabetokens.
double
{}
0.00001
- reasoning_cost (Pflichtfeld): s580
s580: number
Interne Begründungstokens.
double
{}
0.00001
- request_cost (Pflichtfeld): s581
s581: number
Feste Gebühr je Upstream-Anfrage.
double
{}
0.00001
- server_tool_cost (Pflichtfeld): s582
s582: number
Native Server-Tools einschließlich Websuche.
double
{}
0.00001
- created_at (Pflichtfeld): s704
s704: string
Anfrageeingang beim Gateway nach RFC 3339 in UTC.
date-time
{}
"2026-10-19T08:15:42.118Z"
- currency (Pflichtfeld): s705
s705: string
Währung von total_cost, usage und upstream_inference_cost: immer EUR.
{}
"EUR"
- data_region (Pflichtfeld): s706
s706: string
Verarbeitungsort der Generierung. Immer europe.
"global", "europe"
{}
- error_type (optional): s707
s707: string | null
Fehlertyp unter error.metadata.type. Für Programme stabil. Der Abschnitt „Fehler“ in der Einführung nennt für jeden Typ den HTTP-Status und die mögliche Abhilfe.
"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", null
{}
"invalid_parameter"
- external_user (Pflichtfeld): s708
s708: string | null
Der ursprüngliche user-Wert der Anfrage, der lokal mit höchstens 256 Zeichen gespeichert wird.
{}
- finish_reason (Pflichtfeld): s709
s709: string | null
Abschlussgrund der ersten Auswahl (stop, length, tool_calls, content_filter, error). Null, wenn sie noch nicht beendet ist.
{}
"stop"
- first_byte_latency (optional): s710
s710: number | null
Millisekunden vom Eingang der Anfrage bis zum ersten Byte des Providers bei Streams oder bis zur vollständigen Antwort ohne Streaming. Null, wenn kein Provider geantwortet hat.
double
{}
310
- gateway_overhead (Pflichtfeld): s711
s711: number | null
Zeit des Gateways für die Anfrage in Millisekunden mit Mikrosekundengenauigkeit: timings.total abzüglich der Wartezeit auf Provider (timings.upstream, timings.streaming) und auf Speicherbudgets oder die Aufzeichnungswarteschlange (queue_time). Enthält das Einlesen des Anfrageinhalts (timings.body). Null, wenn nicht gemessen. Gateway-Erweiterung.
double
{}
0.412
- generation_time (Pflichtfeld): s712
s712: number | null
Dauer des antwortenden Providers vom Senden der Anfrage bis zum Ende seiner Antwort in Millisekunden. Null, wenn kein Provider geantwortet hat.
double
{}
1180
- http_referer (Pflichtfeld): s713
s713: string | null
HTTP-Referer-Header der Anwendung, der lokal mit begrenzter Länge gespeichert wird.
{}
- id (Pflichtfeld): s714
s714: string
Generierungs-ID. Identisch mit der id der Chatantwort und dem Antwortheader x-generation-id.
{}
"gen-01k7tm9qz3f5c8x2v6b4n0m7hd"
- is_byok (Pflichtfeld): s715
s715: boolean
Whether the last inference attempt used the organization's own provider credential.
{}
- latency (Pflichtfeld): s716
s716: number | null
Millisekunden vom Eingang der Anfrage bis zum Ende der Generierung.
double
{}
1250
- media_conversions (optional): s717
s717: integer
Completed media transport conversions across attempts. Omitted when none occurred; includes URL loading for OCR and never contains media URLs, tokens or contents.
int32
{"minimum":"0"}
1
- metadata (optional): s718
s718: object
Metadaten des Aufrufers: höchstens 16 Zeichenkettenpaare, Schlüssel mit 1 bis 64 und Werte mit 0 bis 512 Zeichen.
{}
{
"workflow": "support"
}
- * (optional): s1166
s1166: any
{}
- model (Pflichtfeld): s719
s719: string
Nach Aliasauflösung und Fallbacks für die Generierung verwendetes Modell.
{}
"deepseek/deepseek-v4.1-flash"
- model_change (optional): s720
s720: object
Unerwartetes Antwortmodell. Nur bekannte kuratierte Modellnamen werden offengelegt.
{}
{
"actual_model": "curated-successor",
"pricing_known": true
}
- actual_model (Pflichtfeld): s881
s881: string | null
Nur die konfigurierte Modellkennung. Null bei unbekannten oder zu langen Providernamen.
{}
- pricing_known (Pflichtfeld): s882
s882: boolean
Ob für dieses Modell eine kuratierte Preisliste verfügbar war.
{}
- moderation_latency (Pflichtfeld): s721
s721: number | null
Moderationsdauer. Immer null, da das Gateway keine Moderation durchführt.
double
{}
- native_finish_reason (Pflichtfeld): s722
s722: string | null
Eigener Abschlussgrund des Providers für die erste Auswahl.
{}
"stop"
- native_tokens_cached (Pflichtfeld): s723
s723: integer | null
Eingabetokens, die der Provider aus seinem Cache gelesen hat. 0, wenn er keine gemeldet hat.
int64
{"minimum":"0"}
0
- native_tokens_completion (Pflichtfeld): s724
s724: integer | null
Vom Provider gezählte Ausgabetokens einschließlich Begründungstokens.
int64
{"minimum":"0"}
25
- native_tokens_completion_images (Pflichtfeld): s725
s725: integer | null
Bildtokens in der Ausgabe. Immer null, da nicht erfasst.
int64
{"minimum":"0"}
- native_tokens_prompt (Pflichtfeld): s726
s726: integer | null
Vom Provider gezählte Eingabetokens.
int64
{"minimum":"0"}
10
- native_tokens_reasoning (Pflichtfeld): s727
s727: integer | null
Begründungstokens innerhalb der Ausgabetokens. 0, wenn der Provider keine gemeldet hat.
int64
{"minimum":"0"}
5
- num_fetches (Pflichtfeld): s728
s728: integer | null
Webabrufe. Immer null, da das Gateway keine Webabrufe anbietet.
int64
{"minimum":"0"}
- num_input_audio_prompt (Pflichtfeld): s729
s729: integer | null
Audioeingaben im Prompt. Immer null, da sie nicht gezählt werden.
int64
{"minimum":"0"}
- num_media_completion (Pflichtfeld): s730
s730: integer | null
Medienelemente in der Antwort. Immer null, da sie nicht gezählt werden.
int64
{"minimum":"0"}
- num_media_prompt (Pflichtfeld): s731
s731: integer | null
Medienelemente im Prompt. Immer null, da sie nicht gezählt werden.
int64
{"minimum":"0"}
- num_search_results (Pflichtfeld): s732
s732: integer | null
Websuchergebnisse. Immer null, da Provider Suchvorgänge, aber keine Ergebnisse melden.
int64
{"minimum":"0"}
- num_web_searches (Pflichtfeld): s733
s733: integer | null
Für diese Generierung berechnete Websuchen. Kein Bestandteil des OpenRouter-Formats. Null, wenn der Provider keine Nutzung gemeldet hat. Ihre Kosten sind Teil von total_cost, nicht von upstream_inference_cost.
int64
{"minimum":"0"}
0
- ocr_cost (Pflichtfeld): s734
s734: number
Gemeinsame EUR-Kosten der PDF-Extraktion, einmalig in total_cost enthalten. Kein Bestandteil von provider_responses[].usage.cost. Provider-Kosten plus dieses Feld berücksichtigen OCR somit einmal.
double
{}
0.002
- origin (Pflichtfeld): s735
s735: string
Ursprung der Anfrage. Immer leer, da nicht aufgezeichnet.
{}
""
- original (Pflichtfeld): s736
s736: object | null
Kosten einer Generierung in der Provider-Währung und der zur EUR-Umrechnung verwendete Wechselkurs. upstream_inference_cost in EUR ist die Summe der Eingabe- und Ausgabekosten, jeweils cost × (1 + markup) / per_eur, abgerundet auf ganze Pico-Einheiten.
{}
{
"currency": "USD",
"exchange_rate": {
"as_of": "2026-10-17T14:00:00Z",
"markup": "0",
"per_eur": "1.1645",
"version": "ecb-2026-10-17"
},
"upstream_inference_cost": 0.0000244
}
- cost_details (optional): s1167
s1167: oneOf
{}
oneOf: s1307
s1307: object
Einzelpositionen in der ursprünglichen Währung ohne die nur in EUR berechneten OCR-Kosten. Fehlen bei älteren Belegen.
{}
{
"cache_read_cost": 0.000001,
"cache_write_cost": 0,
"completion_cost": 0.00002,
"currency": "EUR",
"media_cost": 0,
"ocr_cost": 0,
"prompt_cost": 0.00001,
"reasoning_cost": 0,
"request_cost": 0.001,
"server_tool_cost": 0
}
- cache_read_cost (Pflichtfeld): s572
Aus dem Cache gelesene Eingabetokens, einschließlich zwischengespeicherten Audios.
- cache_write_cost (Pflichtfeld): s573
In den Cache geschriebene Eingabetokens, einschließlich verlängerter Speicherfristen.
- completion_cost (Pflichtfeld): s574
Reguläre Ausgabetokens ohne Begründungs- und Audiotokens.
- currency (Pflichtfeld): s575
ISO-4217-Währung aller Einzelpositionen. EUR bei Kundenkosten.
- media_cost (Pflichtfeld): s576
Eingabe- und Ausgabemedientokens, Bildgebühren und transkribierte Sekunden.
- ocr_cost (Pflichtfeld): s577
Gemeinsame OCR-Vorverarbeitung. Wird einmal je Generierung und für Provider-Kosten mit 0 berechnet.
- pii_cost (optional): s578
Gemeinsame EUR-Kosten der Erkennung personenbezogener Daten, einmalig in der Kundengesamtsumme enthalten.
- prompt_cost (Pflichtfeld): s579
Nicht zwischengespeicherte reguläre Eingabetokens.
- reasoning_cost (Pflichtfeld): s580
Interne Begründungstokens.
- request_cost (Pflichtfeld): s581
Feste Gebühr je Upstream-Anfrage.
- server_tool_cost (Pflichtfeld): s582
Native Server-Tools einschließlich Websuche.
oneOf: s588
s588: null
{}
- currency (Pflichtfeld): s1168
s1168: string
Währung der Provider-Preisliste nach ISO 4217.
{}
"USD"
- exchange_rate (Pflichtfeld): s1169
s1169: object
Wechselkurs der Anfrage.
{}
{
"as_of": "2026-10-17T14:00:00Z",
"markup": "0",
"per_eur": "1.1645",
"version": "ecb-2026-10-17"
}
- as_of (Pflichtfeld): s653
s653: string
Veröffentlichungszeitpunkt der Wechselkurse nach RFC 3339 in UTC.
date-time
{}
"2026-10-17T14:00:00Z"
- markup (Pflichtfeld): s654
s654: string
Aufschlag für Wechselkursrisiken als Dezimalbruch. "0.02" entspricht 2 %.
{}
"0"
- per_eur (Pflichtfeld): s655
s655: string
Währungseinheiten, die ein Euro kauft, nach EZB-Konvention als Dezimalzeichenkette.
{}
"1.1645"
- version (Pflichtfeld): s656
s656: string
Version des Wechselkursstands.
{}
"ecb-2026-10-17"
- upstream_inference_cost (Pflichtfeld): s1170
s1170: number
Vom Provider berechneter Betrag in currency.
double
{}
0.0000244
- parent_id (optional): s737
s737: string | null
Die frühere Generierung, die diese fortsetzt, sofern das Gateway die Anfrage als Fortsetzung einer Unterhaltung erkannt hat (Agentenabläufe). Andernfalls null.
{}
- pii_cost (optional): s578
Gemeinsame EUR-Kosten der Erkennung personenbezogener Daten, einmalig in der Kundengesamtsumme enthalten.
- preprocessing (optional): s738
s738: array
Known paid OCR and PII attempts, including unusable paid responses before fallback, plus one aggregate for free text decoding. At most 16 paid attempts of each kind. No documents, plaintext, detector spans or responses. Historical generations omit this extension rather than inventing quantities.
{"maxItems":"33"}
s137: object
One evidenced preprocessing step, independent of later fallback or inference.
{"additionalProperties":"false"}
{
"cost_pico_eur": "2000000000",
"exchange_rate": null,
"id": "file-parser",
"kind": "ocr",
"model": "mistralai/mistral-ocr-4.1",
"original_cost": {
"currency": "EUR",
"picos": "2000000000"
},
"price_version": "saved-tariff-hash",
"provider": "mistral",
"quantity": 2,
"unit": "page"
}
- cost_pico_eur (Pflichtfeld): s765
s765: string
Customer charge in EUR picos, as an exact nonnegative integer string.
{"pattern":"\"^[0-9]+$\""}
"2000000000"
- exchange_rate (Pflichtfeld): s766
s766: object | null
Ein Wechselkurs aus dem Kursstand des Gateways.
{}
{
"as_of": "2026-10-17T14:00:00Z",
"markup": "0",
"per_eur": "1.1645",
"version": "ecb-2026-10-17"
}
- as_of (Pflichtfeld): s653
Veröffentlichungszeitpunkt der Wechselkurse nach RFC 3339 in UTC.
- markup (Pflichtfeld): s654
Aufschlag für Wechselkursrisiken als Dezimalbruch. "0.02" entspricht 2 %.
- per_eur (Pflichtfeld): s655
Währungseinheiten, die ein Euro kauft, nach EZB-Konvention als Dezimalzeichenkette.
- version (Pflichtfeld): s656
Version des Wechselkursstands.
- execution (optional): s767
s767: string
Execution mode; absent in native and historical receipts.
"native", "llm_span_extract", "llm_vision_transcribe"
{}
- fallbacks (optional): s768
s768: array
On a text_layer receipt: one entry per document for which automatic file-parser continued with paid OCR after the text layer, in document order. Absent otherwise.
{"maxItems":"16"}
[
"no_text"
]
s214: string
Why automatic file-parser sent a document to OCR after the media worker's text layer.
"no_text", "worker_unavailable", "conversion_limit"
{}
- id (optional): s769
s769: string
Executed bridge ID. OCR in Chat/Responses uses file-parser; absent for direct preprocessing endpoints, PII detection and historical receipts.
{}
"file-parser"
- kind (Pflichtfeld): s770
s770: string
ocr, pii, transcription, own render/surcharge lines, free gateway-only text or the worker's PDF text_layer, never an inference token charge.
"ocr", "pii", "text", "render", "surcharge", "transcription", "text_layer"
{}
- model (Pflichtfeld): s771
s771: string
Public catalog model selected for this preprocessing attempt.
{}
"mistralai/mistral-ocr-4.1"
- original_cost (Pflichtfeld): s772
s772: object
Exact contractual provider amount in the route tariff's native currency.
{"additionalProperties":"false"}
- currency (Pflichtfeld): s936
s936: string
Currency of the route tariff.
"EUR", "USD", "CHF", "GBP"
{}
- picos (Pflichtfeld): s937
s937: string
Nonnegative amount in 10^-12 currency units, as an exact integer string.
{"pattern":"\"^[0-9]+$\""}
"2000000000"
- price_version (Pflichtfeld): s773
s773: string
SHA-256 of the immutable route price schedule, including its page/character tariff. free for gateway-only text decoding, which has no tariff.
{}
"b89318c1b25d981dd50b604ff1329a534e0e5459bfb409ac69ce61b5703f379c2"
- provider (Pflichtfeld): s774
s774: string
Configured provider identity, never credentials or a request URL.
{}
"mistral"
- quantity (Pflichtfeld): s775
s775: integer
Exact billable pages or Unicode scalar values of this one attempt.
int64
{"minimum":"0"}
2
- rejected_count (optional): s776
s776: integer
Number of rejected span candidates, retained even if local parsing fails.
int64
{"minimum":"0"}
- task_version (optional): s777
s777: string
Version of the gateway-owned LLM preprocessing task; never provider-authored text.
{"minLength":"1","maxLength":"64"}
- token_usage (optional): s778
s778: object
Confirmed model tokens for LLM PII or image-chat OCR, never a substitute for the scanned character or processed page quantity. Absent on page-priced native OCR.
{"additionalProperties":"false"}
- cache_write_tokens (optional): s941
s941: integer
In den Cache geschriebene Eingabetokens, in prompt_tokens enthalten; 0 bei fehlender Angabe.
int64
{"minimum":"0"}
0
- cached_tokens (optional): s942
s942: integer
Aus dem Cache gelesene Eingabetokens, in prompt_tokens enthalten; 0 bei fehlender Angabe.
int64
{"minimum":"0"}
0
- completion_tokens (Pflichtfeld): s943
s943: integer
All output tokens reported by the provider.
int64
{"minimum":"0"}
128
- costs (optional): s944
s944: object
Exact token pricing result. Required for LLM PII and OCR; optional for native OCR.
{"additionalProperties":"false"}
- customer (Pflichtfeld): s938
s938: object
Customer EUR costs, retaining the provider pricing path's group rounding.
{"additionalProperties":"false"}
- cache_read (Pflichtfeld): s928
s928: string
Cached input token cost.
{}
- cache_write (Pflichtfeld): s929
s929: string
Cache creation token cost.
{}
- completion (Pflichtfeld): s930
s930: string
Ordinary output token cost.
{}
- media (Pflichtfeld): s931
s931: string
Media cost.
{}
- prompt (Pflichtfeld): s932
s932: string
Ordinary input token cost.
{}
- reasoning (Pflichtfeld): s933
s933: string
Reasoning token cost.
{}
- request (Pflichtfeld): s934
s934: string
Fixed request cost.
{}
- server_tool (Pflichtfeld): s935
s935: string
Native server tool cost.
{}
- original (Pflichtfeld): s939
s939: object
Original-currency costs, before FX, in the enclosing original_cost currency.
{"additionalProperties":"false"}
- cache_read (Pflichtfeld): s928
Cached input token cost.
- cache_write (Pflichtfeld): s929
Cache creation token cost.
- completion (Pflichtfeld): s930
Ordinary output token cost.
- media (Pflichtfeld): s931
Media cost.
- prompt (Pflichtfeld): s932
Ordinary input token cost.
- reasoning (Pflichtfeld): s933
Reasoning token cost.
- request (Pflichtfeld): s934
Fixed request cost.
- server_tool (Pflichtfeld): s935
Native server tool cost.
- purchase (Pflichtfeld): s940
s940: object
Procurement EUR costs without customer markup, retaining exact group rounding.
{"additionalProperties":"false"}
- cache_read (Pflichtfeld): s928
Cached input token cost.
- cache_write (Pflichtfeld): s929
Cache creation token cost.
- completion (Pflichtfeld): s930
Ordinary output token cost.
- media (Pflichtfeld): s931
Media cost.
- prompt (Pflichtfeld): s932
Ordinary input token cost.
- reasoning (Pflichtfeld): s933
Reasoning token cost.
- request (Pflichtfeld): s934
Fixed request cost.
- server_tool (Pflichtfeld): s935
Native server tool cost.
- prompt_tokens (Pflichtfeld): s945
s945: integer
All input tokens reported by the provider.
int64
{"minimum":"0"}
256
- reasoning_tokens (optional): s946
s946: integer
Diagnostic reasoning counter, absent if unreliable or unavailable.
int64
{"minimum":"0"}
- unit (Pflichtfeld): s779
s779: string
page for OCR and the text layer; character for PII; document for free text decoding; second for audio transcription.
"page", "character", "document", "second"
{}
- preset_id (Pflichtfeld): s739
s739: string | null
Vorlage der Anfrage. Immer null, da es keine Vorlagen gibt.
{}
- provider_name (Pflichtfeld): s740
s740: string | null
Für die Generierung verwendeter Provider. Wenn alle Versuche scheiterten, der zuletzt versuchte. Null, wenn kein Provider versucht wurde.
{}
"scaleway"
- provider_responses (Pflichtfeld): s741
s741: array | null
Alle Inferenzversuche in ihrer Reihenfolge (höchstens 16), einschließlich Fehlern und unbekannter Nutzung. Null, wenn kein Versuch begonnen hat. Bekannte Kosten und Wechselkurse bleiben unabhängig von der Inhaltsaufzeichnung über Fallbacks hinweg erhalten. Ein Versuch wird nicht gesendet, wenn seine Metadaten die Versuchsgrenze überschreiten würden.
{"maxItems":"16"}
s191: object
Ein Provider-Versuch einer Generierung in der OpenRouter-Struktur.
{}
{
"id": "chatcmpl-abc123",
"latency": 1200,
"model_permaslug": "deepseek/deepseek-v4.1-flash",
"provider_name": "scaleway",
"status": 200
}
- error_type (Pflichtfeld): s707
Fehlertyp unter error.metadata.type. Für Programme stabil. Der Abschnitt „Fehler“ in der Einführung nennt für jeden Typ den HTTP-Status und die mögliche Abhilfe.
- id (optional): s947
s947: string
Eigene Antwort-ID des Providers. Wird weggelassen, wenn sie fehlt, länger als 128 Bytes ist oder die Zugangsdaten dieses Providers enthält, auch in kodierter Form.
{}
"chatcmpl-abc123"
- is_byok (optional): s948
s948: boolean
This attempt used the organization's own provider credential.
{}
true
- latency (optional): s949
s949: number
Dauer des Versuchs in Millisekunden.
double
{}
1200
- model_permaslug (optional): s950
s950: string
Vom Versuch angefordertes Modell.
{}
"deepseek/deepseek-v4.1-flash"
- provider_name (optional): s951
s951: string
Versuchter Provider.
{}
"scaleway"
- status (Pflichtfeld): s952
s952: integer | null
Ursprünglicher Upstream-HTTP-Status. Null, wenn nicht vorgehalten. Der aktuelle Normalisierer erhält Nutzungsdaten, aber keinen Transportstatus. Der Gateway-Fehler steht unter error_type.
int32
{"minimum":"0"}
200
- usage (Pflichtfeld): s953
s953: object | null
Je Inferenzversuch vorgehaltene Provider-Nutzung, unabhängig von den Kundenkosten. Beträge sind exakte EUR-Werte auf Pico-Basis. OCR wird einmal je Generierung abgerechnet.
{}
{
"cost": 0.000021,
"currency": "EUR",
"original": null,
"server_tool_cost": 0,
"tokens_cached": 0,
"tokens_completion": 25,
"tokens_prompt": 10,
"tokens_reasoning": 5,
"web_searches": 0
}
- cost (Pflichtfeld): s1235
s1235: number
Bekannte Kosten für Inferenz und Server-Tools ohne gemeinsam genutzte OCR-Kosten. Bleiben auch erhalten, wenn dieser Versuch nicht an den Client ausgeliefert werden konnte. Werden nie über Gleitkommazahlen summiert.
double
{}
0.000021
- cost_details (optional): s1236
s1236: oneOf
{}
oneOf: s1332
s1332: object
Überschneidungsfreie Provider-Kostenpositionen ohne gemeinsam genutzte OCR-Kosten. Bei älteren Belegen nicht vorhanden.
{}
{
"cache_read_cost": 0.000001,
"cache_write_cost": 0,
"completion_cost": 0.00002,
"currency": "EUR",
"media_cost": 0,
"ocr_cost": 0,
"prompt_cost": 0.00001,
"reasoning_cost": 0,
"request_cost": 0.001,
"server_tool_cost": 0
}
- cache_read_cost (Pflichtfeld): s572
Aus dem Cache gelesene Eingabetokens, einschließlich zwischengespeicherten Audios.
- cache_write_cost (Pflichtfeld): s573
In den Cache geschriebene Eingabetokens, einschließlich verlängerter Speicherfristen.
- completion_cost (Pflichtfeld): s574
Reguläre Ausgabetokens ohne Begründungs- und Audiotokens.
- currency (Pflichtfeld): s575
ISO-4217-Währung aller Einzelpositionen. EUR bei Kundenkosten.
- media_cost (Pflichtfeld): s576
Eingabe- und Ausgabemedientokens, Bildgebühren und transkribierte Sekunden.
- ocr_cost (Pflichtfeld): s577
Gemeinsame OCR-Vorverarbeitung. Wird einmal je Generierung und für Provider-Kosten mit 0 berechnet.
- pii_cost (optional): s578
Gemeinsame EUR-Kosten der Erkennung personenbezogener Daten, einmalig in der Kundengesamtsumme enthalten.
- prompt_cost (Pflichtfeld): s579
Nicht zwischengespeicherte reguläre Eingabetokens.
- reasoning_cost (Pflichtfeld): s580
Interne Begründungstokens.
- request_cost (Pflichtfeld): s581
Feste Gebühr je Upstream-Anfrage.
- server_tool_cost (Pflichtfeld): s582
Native Server-Tools einschließlich Websuche.
oneOf: s588
- currency (Pflichtfeld): s1237
s1237: string
Währung von cost und server_tool_cost dieses Versuchs. Immer EUR.
{}
"EUR"
- original (Pflichtfeld): s1238
s1238: object | null
Kosten einer Generierung in der Provider-Währung und der zur EUR-Umrechnung verwendete Wechselkurs. upstream_inference_cost in EUR ist die Summe der Eingabe- und Ausgabekosten, jeweils cost × (1 + markup) / per_eur, abgerundet auf ganze Pico-Einheiten.
{}
{
"currency": "USD",
"exchange_rate": {
"as_of": "2026-10-17T14:00:00Z",
"markup": "0",
"per_eur": "1.1645",
"version": "ecb-2026-10-17"
},
"upstream_inference_cost": 0.0000244
}
- cost_details (optional): s1333
s1333: oneOf
{}
oneOf: s1348
s1348: object
Einzelpositionen in der ursprünglichen Währung ohne die nur in EUR berechneten OCR-Kosten. Fehlen bei älteren Belegen.
{}
{
"cache_read_cost": 0.000001,
"cache_write_cost": 0,
"completion_cost": 0.00002,
"currency": "EUR",
"media_cost": 0,
"ocr_cost": 0,
"prompt_cost": 0.00001,
"reasoning_cost": 0,
"request_cost": 0.001,
"server_tool_cost": 0
}
- cache_read_cost (Pflichtfeld): s572
Aus dem Cache gelesene Eingabetokens, einschließlich zwischengespeicherten Audios.
- cache_write_cost (Pflichtfeld): s573
In den Cache geschriebene Eingabetokens, einschließlich verlängerter Speicherfristen.
- completion_cost (Pflichtfeld): s574
Reguläre Ausgabetokens ohne Begründungs- und Audiotokens.
- currency (Pflichtfeld): s575
ISO-4217-Währung aller Einzelpositionen. EUR bei Kundenkosten.
- media_cost (Pflichtfeld): s576
Eingabe- und Ausgabemedientokens, Bildgebühren und transkribierte Sekunden.
- ocr_cost (Pflichtfeld): s577
Gemeinsame OCR-Vorverarbeitung. Wird einmal je Generierung und für Provider-Kosten mit 0 berechnet.
- pii_cost (optional): s578
Gemeinsame EUR-Kosten der Erkennung personenbezogener Daten, einmalig in der Kundengesamtsumme enthalten.
- prompt_cost (Pflichtfeld): s579
Nicht zwischengespeicherte reguläre Eingabetokens.
- reasoning_cost (Pflichtfeld): s580
Interne Begründungstokens.
- request_cost (Pflichtfeld): s581
Feste Gebühr je Upstream-Anfrage.
- server_tool_cost (Pflichtfeld): s582
Native Server-Tools einschließlich Websuche.
oneOf: s588
- currency (Pflichtfeld): s1168
Währung der Provider-Preisliste nach ISO 4217.
- exchange_rate (Pflichtfeld): s1334
s1334: object
Wechselkurs der Anfrage.
{}
{
"as_of": "2026-10-17T14:00:00Z",
"markup": "0",
"per_eur": "1.1645",
"version": "ecb-2026-10-17"
}
- as_of (Pflichtfeld): s653
Veröffentlichungszeitpunkt der Wechselkurse nach RFC 3339 in UTC.
- markup (Pflichtfeld): s654
Aufschlag für Wechselkursrisiken als Dezimalbruch. "0.02" entspricht 2 %.
- per_eur (Pflichtfeld): s655
Währungseinheiten, die ein Euro kauft, nach EZB-Konvention als Dezimalzeichenkette.
- version (Pflichtfeld): s656
Version des Wechselkursstands.
- upstream_inference_cost (Pflichtfeld): s1170
Vom Provider berechneter Betrag in currency.
- server_tool_cost (Pflichtfeld): s1239
s1239: number
Anteil von cost für Server-Tools wie native Websuche.
double
{}
0
- tokens_cache_written (optional): s1240
s1240: integer
In den Cache geschriebene Eingabetokens. Fehlen bei Belegen, die vor der detaillierten Preisberechnung erstellt wurden.
int64
{"minimum":"0"}
0
- tokens_cached (Pflichtfeld): s1241
s1241: integer
Zwischengespeicherte Eingabetokens.
int64
{"minimum":"0"}
0
- tokens_completion (Pflichtfeld): s1242
s1242: integer
Ausgabetokens des Providers einschließlich Begründungstokens.
int64
{"minimum":"0"}
25
- tokens_prompt (Pflichtfeld): s1243
s1243: integer
Eingabetokens des Providers.
int64
{"minimum":"0"}
10
- tokens_reasoning (optional): s1244
s1244: integer | null
Reasoning-Tokens als Teil der Ausgabetokens. null, wenn der Provider-Zähler unzuverlässig ist und deshalb nicht ausgegeben wird.
int64
{"minimum":"0"}
5
- web_searches (Pflichtfeld): s1245
s1245: integer
Berechnete native Websuchen.
int64
{"minimum":"0"}
0
- variant (optional): s954
s954: string
Tarifvariante der versuchten Route. Fehlt bei der Standardroute.
{}
"cache"
- queue_time (Pflichtfeld): s742
s742: number | null
Wartezeit der Anfrage auf Speicherbudgets des Gateways für Anfrageinhalte und Provider-Antworten oder auf einen Platz in der Aufzeichnungswarteschlange. In Millisekunden mit Mikrosekundengenauigkeit, identisch mit timings.queue. Null, wenn nicht gemessen. Gateway-Erweiterung.
double
{}
0
- reasoning_effort (optional): s743
s743: string
Von der antwortenden Route angewendete Reasoning-Stufe: die angeforderte oder voreingestellte Stufe, auf die nächstgelegene angebotene Stufe abgebildet. none, wenn Reasoning ausgeschaltet wurde. Fehlt, wenn der eigene Provider-Standard gilt oder das Modell kein Reasoning unterstützt.
{}
"low"
- request_id (Pflichtfeld): s744
s744: string | null
Anfrage-ID. Identisch mit dem Header x-request-id der Anfrage.
{}
"req_01k7tm9qz3f5c8x2v6b4n0m7hd"
- request_parameters (optional): s745
s745: object
Bounded validated request controls, without prompts, tool names/definitions, schemas or stop sequences. stop and tools contain counts; tool_choice is a mode. Unknown parameters appear only as bounded names in unknown. Missing controls stay absent. truncated: true signals omitted metadata or exhausted process capacity. replay_complete: true certifies that validated Chat controls are losslessly represented here or in the separate content/attribution fields. Replay still requires complete authorized content and attribution. Missing/false never permits replay; nested controls omitted from this projection also make the certificate false. Controls use validated Chat-compatible names after Responses translation; api_type identifies the original endpoint. They describe requested values, not route defaults or effective provider settings. Historical generations omit this extension.
{}
- requested_model (Pflichtfeld): s746
s746: string
Das unter model in der Anfrage genannte Modell in seiner ursprünglichen Form. Ein Alias bleibt ein Alias. Weicht von model ab, wenn ein Alias oder Fallback unter models die Anfrage bedient hat.
{}
"eu/fast"
- router (Pflichtfeld): s747
s747: string | null
Der in der Anfrage genannte Alias, sofern ein Alias zu model geführt hat, beispielsweise eu/fast. Andernfalls null.
{}
"eu/fast"
- routing_decisions (optional): s748
s748: array
Zustandsentscheidungen vor den Versuchen, höchstens 20 Einträge. Enthalten nie Anfrageinhalte.
{"maxItems":"20"}
[]
s199: object
Eine begrenzte Erklärung für eine übersprungene, zurückgestellte oder erzwungene Route (Gateway-Erweiterung).
{}
- model (Pflichtfeld): s974
s974: string
Öffentliche Modell-ID.
{}
"mistralai/mistral-nemo"
- provider_name (Pflichtfeld): s975
s975: string
Konfigurierte Provider-ID oder Endpunkt-Tag <provider>/<variant> für eine Tarifvariante.
{}
"scaleway"
- reason (Pflichtfeld): s976
s976: string
Inhaltsfreie Erklärung der Circuit-Breaker- oder Wiederherstellungsentscheidung.
{}
"circuit open: cooldown"
- retry_after_ms (optional): s977
s977: integer | null
Bei der Auswahl verbleibende Sperrzeit in Millisekunden. Null, wenn nicht anwendbar.
int64
{"minimum":"0"}
30000
- traffic_percentage (Pflichtfeld): s978
s978: integer
Aktuell erlaubter Anteil am primären Datenverkehr.
int32
{"minimum":"0"}
25
- service_tier (Pflichtfeld): s749
s749: string | null
Vom Provider gemeldete Dienststufe. Immer null, da nicht erfasst.
{}
- session_id (optional): s750
s750: string | null
Session der Generierung oder null.
{}
- streamed (Pflichtfeld): s751
s751: boolean | null
Ob die Antwort gestreamt wurde.
{}
true
- timings (Pflichtfeld): s752
s752: object | null
Zeit einer Anfrage je Phase, in Millisekunden mit Mikrosekundengenauigkeit. Gemessen mit einer monotonen Uhr vom Eingang der Anfrage bis zum Ende der Generierung. Jeder Zeitpunkt gehört genau einer Phase. Jede Phase wird auf ganze Mikrosekunden abgerundet; ihre Summe entspricht daher total abzüglich höchstens 0,008 ms. Der Gateway-Aufwand ist die Summe aus auth, body, validate, routing und post.
{}
{
"auth": 0.081,
"body": 0.034,
"post": 0.079,
"queue": 0,
"routing": 0.096,
"streaming": 940.374,
"total": 1250,
"upstream": 309.214,
"validate": 0.122
}
- auth (Pflichtfeld): s1171
s1171: number
Annehmen der Anfrage: Authentifizierung und Zulassungsprüfung für den Kunden.
double
{}
0.081
- body (Pflichtfeld): s1172
s1172: number
Einlesen des Anfrageinhalts vom Client.
double
{}
0.034
- post (Pflichtfeld): s1173
s1173: number
Nach einer Antwort ohne Streaming: Normalisierung, Plugins, Kostenabrechnung und Aufzeichnung.
double
{}
0.079
- queue (Pflichtfeld): s1174
s1174: number
Warten auf Speicherbudgets für Anfrageinhalte und Provider-Antworten oder auf einen Platz in der Aufzeichnungswarteschlange.
double
{}
0
- routing (Pflichtfeld): s1175
s1175: number
Routenauswahl, Reservierungen und Gateway-Arbeit rund um jeden Provider-Versuch.
double
{}
0.096
- streaming (Pflichtfeld): s1176
s1176: number
Nur Streams: vom ersten Byte des Providers bis zum Stream-Ende. Sonst 0 ms.
double
{}
940.374
- total (Pflichtfeld): s1177
s1177: number
Vom Eingang der Anfrage bis zum Ende der Generierung. Entspricht latency mit Mikrosekundengenauigkeit.
double
{}
1250
- upstream (Pflichtfeld): s1178
s1178: number
Warten auf Provider über alle Versuche hinweg: vom Senden eines Versuchs bis zum ersten Byte bei Streams oder zur vollständigen Antwort ohne Streaming. Enthält Backoff zwischen Versuchen sowie PDF-Extraktion oder PII-Erkennung vor der Inferenz.
double
{}
309.214
- validate (Pflichtfeld): s1179
s1179: number
Validieren der Anfrage und Prüfung gegen die Regeln des Keys.
double
{}
0.122
- tokens_completion (Pflichtfeld): s753
s753: integer | null
Vom Provider gezählte Ausgabetokens. Null, wenn keine gemeldet wurden.
int64
{"minimum":"0"}
25
- tokens_prompt (Pflichtfeld): s754
s754: integer | null
Vom Provider gezählte Eingabetokens. Null, wenn keine gemeldet wurden.
int64
{"minimum":"0"}
10
- total_cost (Pflichtfeld): s755
s755: number
Dem Kunden berechnete Kosten in EUR: bekannte Nutzung des letzten Versuchs zuzüglich einmaliger OCR-Kosten, auch bei einem Fehler. Frühere fehlgeschlagene Versuche sind Plattformkosten und werden gesondert unter provider_responses[].usage erfasst. Sie werden diesem Betrag nicht hinzugefügt. Ohne Nutzungsdaten des letzten Versuchs sind hier nur OCR-Kosten bekannt. Null bedeutet nicht, dass frühere Versuche kostenlos waren.
double
{}
0.000021
- trace (optional): s756
s756: object
Explizite Trace-Zuordnung und eigene Trace-Eigenschaften, die lokal gespeichert werden. Höchstens 21 Einträge; Schlüssel mit 1 bis 64 Zeichen, Namen mit höchstens 512 Zeichen, Kennungen werden nie gekürzt. Eigene Werte enthalten höchstens 512 JSON-Bytes. X-Trace-Id ergänzt eine fehlende trace_id.
{}
{
"trace_id": "example-trace"
}
- * (optional): s1180
s1180: any
{}
- upstream_id (Pflichtfeld): s757
s757: string | null
Eigene Antwort-ID des Providers. Null, wenn sie fehlt, länger als 128 Bytes ist oder die Zugangsdaten dieses Providers enthält, auch in kodierter Form.
{}
"chatcmpl-791bcf62-080e-4568-87d0-94c72e3b4946"
- upstream_inference_cost (Pflichtfeld): s758
s758: number | null
Kosten der Eingabe- und Ausgabeinferenz in EUR, einschließlich Medien, aber ohne Gebühren für Anfragen, Server-Tools und OCR. Ohne vollständige Provider-Nutzungsdaten null.
double
{}
0.000021
- usage (Pflichtfeld): s759
s759: number
Kosten in EUR. Identisch mit total_cost.
double
{}
0.000021
- usage_estimate (optional): s760
s760: object
UTF-8 text estimate when provider usage is missing. Diagnostic only, except for a cancelled generation whose provider usage could not be read: then its tokens and cost are this estimate at the route's normal prices, within the request's reservation.
{}
{
"completion_tokens": 2,
"estimated": true,
"method": "utf8_bytes_div4",
"prompt_tokens": 4
}
- completion_tokens (Pflichtfeld): s1039
s1039: integer
Ausgegebene Text-, Begründungs- und Tool-Argumentbytes durch vier geteilt und aufgerundet.
int64
{"minimum":"0"}
- estimated (Pflichtfeld): s1040
s1040: boolean
Always true.
{}
- method (Pflichtfeld): s1041
s1041: string
Fixed estimator identifier, never provider-authored text: utf8_bytes_div4 for a diagnostic estimate, delivered_utf8_bytes_div4 for a billed cancellation estimate.
{}
- prompt_tokens (Pflichtfeld): s1042
s1042: integer
UTF-8-Textbytes durch vier geteilt und aufgerundet. Bild- und Audiodaten sind ausgeschlossen.
int64
{"minimum":"0"}
- total_tokens (Pflichtfeld): s1043
s1043: integer
Summe der beiden geschätzten Texttokenzahlen.
int64
{"minimum":"0"}
- user_agent (Pflichtfeld): s761
s761: string | null
User-Agent-Header der Anfrage, der lokal mit begrenzter Länge gespeichert wird.
{}
- variant (optional): s762
s762: string
Tarifvariante der Provider-Route, die die Generierung beantwortet hat: Endpunkt-Tag <provider_name>/<variant>, beispielsweise grunden/cache, angefordert über provider.only oder provider.order. Fehlt bei der Standardroute.
{}
"cache"
- web_search_engine (Pflichtfeld): s763
s763: string | null
native, wenn der Provider für diese Generierung im Web gesucht hat. Das Gateway bietet nur die eigene Suche des Providers an. Andernfalls null.
{}
- workspace_id (Pflichtfeld): s764
s764: string | null
Compatibility attribution: the organization's ID. This field does not identify a management workspace; use the management API for the key's actual workspace.
{}
"org_01k7tm2c4e6g8j0k2m4p6r8t0v"
Antwort 400: application/json
Abfrageparameter id fehlt, ist leer oder wurde mehrfach angegeben (invalid_parameter).
{
"error": {
"code": 400,
"message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
"metadata": {
"docs_url": "/docs#description/model-not-found",
"issues": [
{
"code": "unknown_model",
"message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
"path": "$.model"
}
],
"remedy_hint": "Did you mean deepseek/deepseek-v4.1-flash?",
"request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
"retryable": false,
"type": "model_not_found"
}
},
"user_id": "org_01k7tm2c4e6g8j0k2m4p6r8t0v"
}
s3: object
Jede Antwort mit HTTP-Status ab 400 hat diese Struktur im Fehlerformat von OpenRouter. Alle Gateway-Erweiterungen stehen unter error.metadata, damit OpenRouter-Clients keine unbekannte äußere Struktur erhalten. Der Abschnitt „Fehler“ in der Einführung nennt alle Fehlertypen.
{}
{
"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"
]
- 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 401: application/json
API-Key fehlt, ist ungültig oder abgelaufen (authentication).
Antwort 404: application/json
No generation with this ID for the key's organization and workspace: unknown, created by another organization or workspace, not yet ended, or no longer kept (not_found)
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
Gemeinsamer Generierungsspeicher nicht verfügbar. Den Abruf erneut versuchen.