Agentenablauf abrufen

Agent runs without an SDK: if a chat completion's messages continue an earlier request of the same API key (the earlier messages, then the model's answer, then tool results or the next user message), the earlier generation becomes its parent_id. This lists the steps from the first one to the requested generation, each in the format of GET /v1/generation. Never prompts or answers.

Messages are compared after normalization: role, name, text (a string equals text parts with the same text), media by URL or data, tool calls by ID, name and arguments, tool results by tool_call_id; other fields such as reasoning or cache_control do not count, and neither does the text of the answer sent back. The gateway compares keyed fingerprints that never leave it, not the messages themselves. The parent is the most recent completed generation with the longest matching conversation (among the 16 longest candidates). Only keys of the same organization and workspace see a chain; this gateway instance keeps its most recent generations in memory, so a chain starts at its oldest step still kept, and lists at most the 500 most recent steps (truncated).

GET https://api.tokenlane.de/v1/generation/chain

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/chain?id=YOUR_ID' \
  --header 'Authorization: Bearer YOUR_API_KEY'

node

const response = await fetch("https://api.tokenlane.de/v1/generation/chain?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/chain?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/chain?id=YOUR_ID", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
  },
});
console.log(await response.text());

Abfrageparameter: id (Pflichtfeld)

Generierungs-ID des letzten Schritts, beispielsweise die id einer Chatantwort

s7: string

{}

Antwort 200: application/json

Schritte des Ablaufs, beginnend mit dem ersten. Beträge in EUR.

{
  "data": {
    "chain": [],
    "id": "gen-01k7tm9qz3f5c8x2v6b4n0m7hd",
    "truncated": false
  }
}

s17: object

Antwort von GET /v1/generation/chain.

{}

  • data (Pflichtfeld): s306

s306: object

Der Ablauf, der mit der angeforderten Generierung endet.

{}

{
  "chain": [],
  "id": "gen-01k7tm9qz3f5c8x2v6b4n0m7hd",
  "truncated": false
}
  • chain (Pflichtfeld): s664

s664: array

Schritte vom ersten noch vorgehaltenen Schritt bis zur angeforderten Generierung, jeweils im Format von GET /v1/generation. Die parent_id jedes Schritts verweist auf den vorherigen Schritt.

{}

s136: object

Vom Gateway zu einer Generierung aufgezeichnete Angaben: Modell, Provider, Tokens, Kosten, Laufzeiten und Endstatus. Nie Prompt oder Antwort.

Unterschiede zu OpenRouter: total_cost, usage und upstream_inference_cost sind in EUR angegeben, siehe currency. Tokenzahlen stammen vom Provider. tokens_* entspricht native_tokens_*. Felder für nicht angebotene Funktionen wie Anwendungen, Vorlagen, BYOK, Webabrufe, Moderation, Medienanzahlen oder Cache-Nachlässe sind null oder enthalten die jeweils angegebenen festen Werte. upstream_inference_cost enthält nur die Tokenkosten. total_cost ergänzt Server-Tools wie Websuche. Zusätzliche Felder: currency, original, requested_model, first_byte_latency, error_type, parent_id, num_web_searches, gateway_overhead, queue_time und timings.

Eine Generierung erscheint nach ihrem Ende, unabhängig davon, ob sie beantwortet, fehlgeschlagen oder vom Client abgebrochen wurde, und bevor das letzte Byte ihrer Antwort gesendet wird.

{}

{
  "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"
  • id (Pflichtfeld): s665

s665: string

Angeforderte Generierung, der letzte Schritt von chain.

{}

"gen-01k7tm9qz3f5c8x2v6b4n0m7hd"
  • truncated (Pflichtfeld): s666

s666: boolean

Ob frühere Schritte existieren, die wegen einer Gesamtzahl über 500 nicht aufgelistet werden.

{}

false

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

Die gemeinsame Zulassungsprüfung für Kunden ist nicht verfügbar. In Kürze erneut versuchen (no_provider_available).