# 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
curl --request GET \
  --url 'https://api.tokenlane.de/v1/generation?id=YOUR_ID' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## node

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

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

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

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

{}

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

{}

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

{}

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

{}

```json
false
```

- byok_fallback (optional): s698

### s698: boolean | null

An authorized fallback from a customer credential to platform credit occurred.

{}

```json
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.

{}

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

```json
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

{}

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

```json
100000
```

- reported_tokens (Pflichtfeld): s506

### s506: integer

The part of `tokens` taken from the provider's reported usage.

int64

{"minimum":"0"}

```json
1480
```

- request_number (Pflichtfeld): s507

### s507: integer

One-based number of this request within the customer identity's UTC calendar month.

int64

{"minimum":"0"}

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

```json
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.

{}

```json
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.

{}

```json
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.

{}

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

{}

```json
0.00001
```

- cache_write_cost (Pflichtfeld): s573

### s573: number

In den Cache geschriebene Eingabetokens, einschließlich verlängerter Speicherfristen.

double

{}

```json
0.00001
```

- completion_cost (Pflichtfeld): s574

### s574: number

Reguläre Ausgabetokens ohne Begründungs- und Audiotokens.

double

{}

```json
0.00001
```

- currency (Pflichtfeld): s575

### s575: string

ISO-4217-Währung aller Einzelpositionen. EUR bei Kundenkosten.

{}

```json
"EUR"
```

- media_cost (Pflichtfeld): s576

### s576: number

Eingabe- und Ausgabemedientokens, Bildgebühren und transkribierte Sekunden.

double

{}

```json
0.00001
```

- ocr_cost (Pflichtfeld): s577

### s577: number

Gemeinsame OCR-Vorverarbeitung. Wird einmal je Generierung und für Provider-Kosten mit 0 berechnet.

double

{}

```json
0.00001
```

- pii_cost (optional): s578

### s578: number | null

Gemeinsame EUR-Kosten der Erkennung personenbezogener Daten, einmalig in der Kundengesamtsumme enthalten.

double

{}

```json
0.000002
```

- prompt_cost (Pflichtfeld): s579

### s579: number

Nicht zwischengespeicherte reguläre Eingabetokens.

double

{}

```json
0.00001
```

- reasoning_cost (Pflichtfeld): s580

### s580: number

Interne Begründungstokens.

double

{}

```json
0.00001
```

- request_cost (Pflichtfeld): s581

### s581: number

Feste Gebühr je Upstream-Anfrage.

double

{}

```json
0.00001
```

- server_tool_cost (Pflichtfeld): s582

### s582: number

Native Server-Tools einschließlich Websuche.

double

{}

```json
0.00001
```

- created_at (Pflichtfeld): s704

### s704: string

Anfrageeingang beim Gateway nach RFC 3339 in UTC.

date-time

{}

```json
"2026-10-19T08:15:42.118Z"
```

- currency (Pflichtfeld): s705

### s705: string

Währung von `total_cost`, `usage` und `upstream_inference_cost`: immer `EUR`.

{}

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

{}

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

{}

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

{}

```json
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

{}

```json
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

{}

```json
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`.

{}

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

{}

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

```json
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.

{}

```json
{
  "workflow": "support"
}
```

- * (optional): s1166

### s1166: any

{}

- model (Pflichtfeld): s719

### s719: string

Nach Aliasauflösung und Fallbacks für die Generierung verwendetes Modell.

{}

```json
"deepseek/deepseek-v4.1-flash"
```

- model_change (optional): s720

### s720: object

Unerwartetes Antwortmodell. Nur bekannte kuratierte Modellnamen werden offengelegt.

{}

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

{}

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

```json
0
```

- native_tokens_completion (Pflichtfeld): s724

### s724: integer | null

Vom Provider gezählte Ausgabetokens einschließlich Begründungstokens.

int64

{"minimum":"0"}

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

```json
10
```

- native_tokens_reasoning (Pflichtfeld): s727

### s727: integer | null

Begründungstokens innerhalb der Ausgabetokens. 0, wenn der Provider keine gemeldet hat.

int64

{"minimum":"0"}

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

```json
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

{}

```json
0.002
```

- origin (Pflichtfeld): s735

### s735: string

Ursprung der Anfrage. Immer leer, da nicht aufgezeichnet.

{}

```json
""
```

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

{}

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

{}

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

{}

```json
"USD"
```

- exchange_rate (Pflichtfeld): s1169

### s1169: object

Wechselkurs der Anfrage.

{}

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

{}

```json
"2026-10-17T14:00:00Z"
```

- markup (Pflichtfeld): s654

### s654: string

Aufschlag für Wechselkursrisiken als Dezimalbruch. `"0.02"` entspricht 2 %.

{}

```json
"0"
```

- per_eur (Pflichtfeld): s655

### s655: string

Währungseinheiten, die ein Euro kauft, nach EZB-Konvention als Dezimalzeichenkette.

{}

```json
"1.1645"
```

- version (Pflichtfeld): s656

### s656: string

Version des Wechselkursstands.

{}

```json
"ecb-2026-10-17"
```

- upstream_inference_cost (Pflichtfeld): s1170

### s1170: number

Vom Provider berechneter Betrag in `currency`.

double

{}

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

```json
{
  "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]+$\""}

```json
"2000000000"
```

- exchange_rate (Pflichtfeld): s766

### s766: object | null

Ein Wechselkurs aus dem Kursstand des Gateways.

{}

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

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

{}

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

{}

```json
"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]+$\""}

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

{}

```json
"b89318c1b25d981dd50b604ff1329a534e0e5459bfb409ac69ce61b5703f379c2"
```

- provider (Pflichtfeld): s774

### s774: string

Configured provider identity, never credentials or a request URL.

{}

```json
"mistral"
```

- quantity (Pflichtfeld): s775

### s775: integer

Exact billable pages or Unicode scalar values of this one attempt.

int64

{"minimum":"0"}

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

```json
0
```

- cached_tokens (optional): s942

### s942: integer

Aus dem Cache gelesene Eingabetokens, in prompt_tokens enthalten; 0 bei fehlender Angabe.

int64

{"minimum":"0"}

```json
0
```

- completion_tokens (Pflichtfeld): s943

### s943: integer

All output tokens reported by the provider.

int64

{"minimum":"0"}

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

```json
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.

{}

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

{}

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

{}

```json
"chatcmpl-abc123"
```

- is_byok (optional): s948

### s948: boolean

This attempt used the organization's own provider credential.

{}

```json
true
```

- latency (optional): s949

### s949: number

Dauer des Versuchs in Millisekunden.

double

{}

```json
1200
```

- model_permaslug (optional): s950

### s950: string

Vom Versuch angefordertes Modell.

{}

```json
"deepseek/deepseek-v4.1-flash"
```

- provider_name (optional): s951

### s951: string

Versuchter Provider.

{}

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

```json
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.

{}

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

{}

```json
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.

{}

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

{}

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

{}

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

{}

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

{}

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

{}

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

```json
0
```

- tokens_cached (Pflichtfeld): s1241

### s1241: integer

Zwischengespeicherte Eingabetokens.

int64

{"minimum":"0"}

```json
0
```

- tokens_completion (Pflichtfeld): s1242

### s1242: integer

Ausgabetokens des Providers einschließlich Begründungstokens.

int64

{"minimum":"0"}

```json
25
```

- tokens_prompt (Pflichtfeld): s1243

### s1243: integer

Eingabetokens des Providers.

int64

{"minimum":"0"}

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

```json
5
```

- web_searches (Pflichtfeld): s1245

### s1245: integer

Berechnete native Websuchen.

int64

{"minimum":"0"}

```json
0
```

- variant (optional): s954

### s954: string

Tarifvariante der versuchten Route. Fehlt bei der Standardroute.

{}

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

{}

```json
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.

{}

```json
"low"
```

- request_id (Pflichtfeld): s744

### s744: string | null

Anfrage-ID. Identisch mit dem Header `x-request-id` der Anfrage.

{}

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

{}

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

{}

```json
"eu/fast"
```

- routing_decisions (optional): s748

### s748: array

Zustandsentscheidungen vor den Versuchen, höchstens 20 Einträge. Enthalten nie Anfrageinhalte.

{"maxItems":"20"}

```json
[]
```

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

{}

```json
"mistralai/mistral-nemo"
```

- provider_name (Pflichtfeld): s975

### s975: string

Konfigurierte Provider-ID oder Endpunkt-Tag `<provider>/<variant>` für eine Tarifvariante.

{}

```json
"scaleway"
```

- reason (Pflichtfeld): s976

### s976: string

Inhaltsfreie Erklärung der Circuit-Breaker- oder Wiederherstellungsentscheidung.

{}

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

```json
30000
```

- traffic_percentage (Pflichtfeld): s978

### s978: integer

Aktuell erlaubter Anteil am primären Datenverkehr.

int32

{"minimum":"0"}

```json
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.

{}

```json
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`.

{}

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

{}

```json
0.081
```

- body (Pflichtfeld): s1172

### s1172: number

Einlesen des Anfrageinhalts vom Client.

double

{}

```json
0.034
```

- post (Pflichtfeld): s1173

### s1173: number

Nach einer Antwort ohne Streaming: Normalisierung, Plugins, Kostenabrechnung und Aufzeichnung.

double

{}

```json
0.079
```

- queue (Pflichtfeld): s1174

### s1174: number

Warten auf Speicherbudgets für Anfrageinhalte und Provider-Antworten oder auf einen Platz in der Aufzeichnungswarteschlange.

double

{}

```json
0
```

- routing (Pflichtfeld): s1175

### s1175: number

Routenauswahl, Reservierungen und Gateway-Arbeit rund um jeden Provider-Versuch.

double

{}

```json
0.096
```

- streaming (Pflichtfeld): s1176

### s1176: number

Nur Streams: vom ersten Byte des Providers bis zum Stream-Ende. Sonst 0 ms.

double

{}

```json
940.374
```

- total (Pflichtfeld): s1177

### s1177: number

Vom Eingang der Anfrage bis zum Ende der Generierung. Entspricht `latency` mit Mikrosekundengenauigkeit.

double

{}

```json
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

{}

```json
309.214
```

- validate (Pflichtfeld): s1179

### s1179: number

Validieren der Anfrage und Prüfung gegen die Regeln des Keys.

double

{}

```json
0.122
```

- tokens_completion (Pflichtfeld): s753

### s753: integer | null

Vom Provider gezählte Ausgabetokens. Null, wenn keine gemeldet wurden.

int64

{"minimum":"0"}

```json
25
```

- tokens_prompt (Pflichtfeld): s754

### s754: integer | null

Vom Provider gezählte Eingabetokens. Null, wenn keine gemeldet wurden.

int64

{"minimum":"0"}

```json
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

{}

```json
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.

{}

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

{}

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

{}

```json
0.000021
```

- usage (Pflichtfeld): s759

### s759: number

Kosten in EUR. Identisch mit `total_cost`.

double

{}

```json
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.

{}

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

{}

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

{}

```json
"org_01k7tm2c4e6g8j0k2m4p6r8t0v"
```

## Antwort 400: application/json

Abfrageparameter `id` fehlt, ist leer oder wurde mehrfach angegeben (`invalid_parameter`).

```json
{
  "error": {
    "code": 400,
    "message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
    "metadata": {
      "docs_url": "/docs#description/model-not-found",
      "issues": [
        {
          "code": "unknown_model",
          "message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
          "path": "$.model"
        }
      ],
      "remedy_hint": "Did you mean deepseek/deepseek-v4.1-flash?",
      "request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
      "retryable": false,
      "type": "model_not_found"
    }
  },
  "user_id": "org_01k7tm2c4e6g8j0k2m4p6r8t0v"
}
```

### s3: object

Jede Antwort mit HTTP-Status ab 400 hat diese Struktur im Fehlerformat von OpenRouter. Alle Gateway-Erweiterungen stehen unter `error.metadata`, damit OpenRouter-Clients keine unbekannte äußere Struktur erhalten. Der Abschnitt „Fehler“ in der Einführung nennt alle Fehlertypen.

{}

```json
{
  "error": {
    "code": 400,
    "message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
    "metadata": {
      "docs_url": "/docs#description/model-not-found",
      "issues": [
        {
          "code": "unknown_model",
          "message": "deepseek/deepseek-v4.1-flsh is not a valid model ID",
          "path": "$.model"
        }
      ],
      "remedy_hint": "Did you mean deepseek/deepseek-v4.1-flash?",
      "request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
      "retryable": false,
      "type": "model_not_found"
    }
  },
  "user_id": "org_01k7tm2c4e6g8j0k2m4p6r8t0v"
}
```

- error (Pflichtfeld): s238

### s238: object

Fehlerbeschreibung.

{}

```json
{
  "code": 400,
  "message": "temperature must be at most 2, got 5 (and 1 more)",
  "metadata": {
    "docs_url": "/docs#description/invalid-parameter",
    "issues": [
      {
        "code": "out_of_range",
        "message": "temperature must be at most 2, got 5",
        "path": "$.temperature"
      },
      {
        "code": "invalid_value",
        "message": "messages[1].role must be one of system, developer, user, assistant, tool, got \"bot\"",
        "path": "$.messages[1].role"
      }
    ],
    "request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
    "retryable": false,
    "type": "invalid_parameter"
  }
}
```

- code (Pflichtfeld): s633

### s633: integer

HTTP-Status der Antwort als Zahl.

int32

{"minimum":"0"}

```json
400
```

- message (Pflichtfeld): s634

### s634: string

Fehlerbeschreibung auf Englisch. Bei mehreren Problemen werden das erste und die Anzahl weiterer genannt. Alle stehen unter `metadata.issues`. Der Text kann sich ändern. Im Code stattdessen `metadata.type` auswerten.

{}

```json
"temperature must be at most 2, got 5"
```

- metadata (optional): s635

### s635: object

Maschinenlesbare Details: Fehlertyp, Anfrage-ID, alle Probleme, ein Lösungsvorschlag und bei Provider-Fehlern der betroffene Provider. Bei Gateway-Fehlern immer vorhanden.

{}

```json
{
  "docs_url": "/docs#description/rate-limited",
  "provider_error": {
    "category": "rate_limited",
    "provider_name": "deepinfra",
    "retry_after": 2,
    "retryable": true,
    "status": 429
  },
  "provider_name": "deepinfra",
  "remedy_hint": "Retry after the Retry-After interval, or allow fallbacks to other providers (provider.allow_fallbacks).",
  "request_id": "req_01k7tm9qz3f5c8x2v6b4n0m7hd",
  "retry_after": 2,
  "retryable": true,
  "type": "rate_limited"
}
```

- available_providers (optional): s639

### s639: array

Provider, die das Modell anbieten, wenn `provider.only` alle ausgeschlossen hat.

{}

```json
[
  "deepinfra",
  "open-inference"
]
```

- docs_url (Pflichtfeld): s640

### s640: string

Link zum Abschnitt dieses Fehlertyps in der Dokumentation.

{}

```json
"/docs#description/model-not-found"
```

- failed_routing_step (optional): s641

### s641: string

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

{}

```json
"Filter by Max Price"
```

- issues (optional): s642

### s642: array

Alle erkannten Probleme der Anfrage, damit sie gemeinsam behoben werden können. Höchstens 20 Einträge. Bei Routing-Fehlern ein Eintrag je ausgeschlossener Route, bei `no_provider_available` einer je fehlgeschlagenem Versuch.

{}

### s123: object

Ein Anfrageproblem, ein Ausschlussgrund einer Route oder ein fehlgeschlagener Versuch.

{}

```json
{
  "code": "invalid_url",
  "message": "messages[2].content[0].image_url.url must be an http(s) URL or a base64 data URL",
  "path": "$.messages[2].content[0].image_url.url"
}
```

- code (Pflichtfeld): s636

### s636: string

Art des Problems. Für Programme stabil.

"required", "invalid_type", "invalid_value", "out_of_range", "empty", "invalid_url", "invalid_base64", "unsupported_media_type", "media_type_mismatch", "media_too_large", "too_many_media", "unsupported_media_transport", "media_fetch_failed", "unknown_tool", "unknown_model", "not_available", "not_allowed", "route_excluded", "bridge_failed", "provider_failed"

{}

```json
"out_of_range"
```

- message (Pflichtfeld): s637

### s637: string

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

{}

```json
"temperature must be at most 2, got 5"
```

- path (Pflichtfeld): s638

### s638: string

Position des Problems: JSONPath des Felds im Anfrageinhalt, beispielsweise `$.messages[2].content[0].image_url.url`, oder `query.<name>` bei einem Abfrageparameter.

{}

```json
"$.temperature"
```

- provider_error (optional): s643

### s643: oneOf

Sichere Provider-Diagnosen, einheitlich für HTTP-Fehler und finale Stream-Ereignisse.

{}

oneOf: s1158

### s1158: object

Provider-Diagnosen ohne vom Provider verfassten Text. HTTP-Fehler und finale SSE-Fehler verwenden dieselbe Struktur. Beliebige Upstream-Meldungen und Metadaten werden verworfen.

{}

```json
{
  "category": "rate_limited",
  "provider_name": "deepinfra",
  "retry_after": 2,
  "retryable": true,
  "status": 429
}
```

- category (Pflichtfeld): s1299

### s1299: string

Gateway-Klassifizierung anhand von HTTP-Status und erkannten Dialektkennungen.

"rate_limited", "overloaded", "invalid_request", "context_length", "content_filtered", "authentication", "billing", "timeout", "unavailable", "unknown"

{}

```json
"rate_limited"
```

- code (optional): s1300

### s1300: string

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

{}

```json
"rate_limit_exceeded"
```

- provider_name (Pflichtfeld): s1301

### s1301: string

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

{}

```json
"deepinfra"
```

- retry_after (optional): s1302

### s1302: integer

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

int64

{"minimum":"0"}

```json
2
```

- retryable (Pflichtfeld): s1303

### s1303: boolean

Ob der klassifizierte Fehler vorübergehend sein kann. Bei unbekannten Fehlern wird ein sinnvoller erneuter Versuch nicht zugesichert.

{}

- status (optional): s1304

### s1304: integer

Tatsächlich vom Upstream empfangener HTTP-Status, einschließlich 200 bei nativen Fehlern. Fehlt, wenn kein HTTP-Status verfügbar ist.

int32

{"minimum":"0"}

```json
429
```

oneOf: s588

- provider_name (optional): s644

### s644: string

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

{}

```json
"deepinfra"
```

- raw (optional): s645

### s645: string

Reserviertes Feld für OpenRouter-Kompatibilität. Das Gateway befüllt es nie. Freier Provider-Text wird bewusst nicht ausgegeben. Stattdessen provider_error verwenden.

{}

```json
""
```

- remedy_hint (optional): s646

### s646: string

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

{}

```json
"Did you mean deepseek/deepseek-v4.1-flash?"
```

- request_id (Pflichtfeld): s647

### s647: string

Anfrage-ID. Identisch mit dem Antwortheader `x-request-id`. Diese ID bei Supportanfragen angeben.

{}

```json
"req_01k7tm9qz3f5c8x2v6b4n0m7hd"
```

- requested_providers (optional): s648

### s648: array

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

{}

```json
[
  "scaleway"
]
```

- retry_after (optional): s649

### s649: integer

Wartezeit vor einem erneuten Versuch in Sekunden. Wird bei 429 und 503 auch als Header `Retry-After` gesendet.

int64

{"minimum":"0"}

```json
2
```

- retryable (Pflichtfeld): s650

### s650: boolean

Ob dieselbe unveränderte Anfrage bei einem erneuten Versuch erfolgreich sein kann, beispielsweise nach einer Zeitüberschreitung oder einem Anfragelimit. Im Gegensatz zu Fehlern, die eine geänderte Anfrage erfordern.

{}

- routing_funnel (optional): s651

### s651: array

Eingrenzung der Provider durch das Routing. Jeder Schritt nennt die Anzahl verbleibender Routen. Nur bei Routing-Fehlern, im selben Format wie bei OpenRouter.

{}

### s200: object

Ein Routing-Schritt wie unter `routing_funnel` von OpenRouter.

{}

```json
{
  "endpoint_count": 0,
  "reason": "provider.max_price",
  "step": "Filter by Max Price"
}
```

- endpoint_count (Pflichtfeld): s979

### s979: integer

Anzahl der nach diesem Schritt verbleibenden Routen beziehungsweise Modell-Provider.

{"minimum":"0"}

```json
2
```

- reason (optional): s980

### s980: string

Anfragefeld, nach dem der Schritt gefiltert hat.

{}

```json
"provider.only"
```

- step (Pflichtfeld): s981

### s981: string

Name des Schritts wie bei OpenRouter.

{}

```json
"Initial Endpoints"
```

- type (Pflichtfeld): s652

### s652: string

Stabiler Fehlertyp für die Auswertung im Code. Siehe „Fehler“ in der Einführung. Meldungen können sich ändern, der Typ bleibt stabil.

"invalid_request", "invalid_parameter", "unsupported_parameter", "context_length_exceeded", "authentication", "insufficient_credits", "workspace_budget_exceeded", "permission_denied", "moderation", "model_not_found", "no_endpoint", "not_found", "method_not_allowed", "timeout", "payload_too_large", "media_fetch_failed", "rate_limited", "provider_error", "idempotency_conflict", "idempotency_in_progress", "idempotency_unavailable", "provider_invalid_response", "no_provider_available", "byok_invalid_credential", "byok_rate_limited", "byok_unavailable", "feature_unavailable", "internal"

{}

```json
"invalid_parameter"
```

- user_id (optional): s239

### s239: string | null

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

{}

```json
"org_01k7tm2c4e6g8j0k2m4p6r8t0v"
```

## Antwort 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.
