Audio transkribieren

Wandelt Sprache in Text um. Audio als JSON mit Base64 in input_audio (OpenRouter-Format) oder als multipart/form-data mit einem file-Teil (OpenAI-Format, wie von dessen SDKs gesendet) übermitteln. Antwort wie bei OpenRouter: text und usage mit Kosten in EUR, zusätzlich language, duration und segments bei response_format: verbose_json.

Das Gateway wählt unter Berücksichtigung der provider-Präferenzen einen europäischen Anbieter des Modells und versucht bei einem Fehler den nächsten. Ob der Anbieter einen Upload oder Base64-JSON erhält, bestimmt seine Konfiguration, nicht die Anfrage. Der Body wird vor jedem Anbieteraufruf vollständig validiert; alle Probleme stehen in error.metadata.issues. Audio per URL (input_audio.url, source_url), Sprecherkennzeichnungen (diarize) und keyterms werden von den Anbietern dieses Gateways nicht unterstützt und führen zu 400.

Administrative PII-Anforderungen werden für jede tatsächliche Route einschließlich Fallbacks und Wiederholungen geprüft. Dieser Endpunkt kann seine Eingabe nicht schwärzen: Eine passende Anforderung liefert vor Anbieter-I/O invalid_parameter mit einem not_available-Problem bei $.model.

POST https://api.tokenlane.de/v1/audio/transcriptions

Authentifizierung

[ [ { "name": "Authorization", "description": "API-Key als Bearer-Token im Header Authorization: Authorization: Bearer sk-tl-v1-…. Bestehende sk-eu--Keys bleiben gültig. Fehlende, unbekannte oder abgelaufene Keys erhalten 401 authentication.", "type": "http bearer", "location": "", "scopes": [] } ] ]

curl

curl --request POST \
  --url 'https://api.tokenlane.de/v1/audio/transcriptions' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "input_audio": {
    "data": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YQAAAAA=",
    "format": "wav"
  },
  "language": "de",
  "model": "mistralai/voxtral-mini-transcribe-3-0"
}'

node

const response = await fetch("https://api.tokenlane.de/v1/audio/transcriptions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Content-Type": "application/json",
  },
  body: `{
  "input_audio": {
    "data": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YQAAAAA=",
    "format": "wav"
  },
  "language": "de",
  "model": "mistralai/voxtral-mini-transcribe-3-0"
}`,
});
console.log(await response.text());

python

import os
import urllib.request

body = (r'''{
  "input_audio": {
    "data": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YQAAAAA=",
    "format": "wav"
  },
  "language": "de",
  "model": "mistralai/voxtral-mini-transcribe-3-0"
}''').encode("utf-8")

request = urllib.request.Request(
    "https://api.tokenlane.de/v1/audio/transcriptions",
    method="POST",
    headers={
        "Authorization": "Bearer " + os.environ["TOKENLANE_API_KEY"],
        "Content-Type": "application/json",
    },
    data=body,
)

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/audio/transcriptions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Content-Type": "application/json",
  },
  body: `{
  "input_audio": {
    "data": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YQAAAAA=",
    "format": "wav"
  },
  "language": "de",
  "model": "mistralai/voxtral-mini-transcribe-3-0"
}`,
});
console.log(await response.text());

Header: x-session-id (optional)

Groups the generation into a session, immediately available from GET /v1/sessions/{id}. Use 1 to 256 ASCII letters, digits, '-', '_', '.' or ':'; an ID cannot consist only of dots. A non-null session_id in JSON or multipart takes precedence. Never sent to the provider.

s0: string | null

{}

Header: Idempotency-Key (optional)

Ausdrückliches Opt-in zur verschlüsselten Antwortwiederholung über alle Gateway-Knoten. Ein Wert aus 1 bis 255 druckbaren ASCII-Zeichen pro logischem Vorgang, begrenzt auf die Identität dieses API-Keys. Methode, Pfad und normalisierten Body unverändert wiederholen. Abgeschlossene Antworten bleiben höchstens zehn Minuten verfügbar; eine Wiederholung ist kostenlos und erzeugt keine neue Generierung. Abweichender Inhalt oder eine nicht sicher wiederholbare Antwort ergibt 409. Eine erfolgreiche Wiederholung enthält Idempotent-Replayed: true und erhält die ursprünglichen Request- und Generation-IDs. Siehe /docs/guides/idempotency.

Anfrageinhalt: application/json

{
  "input_audio": {
    "data": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YQAAAAA=",
    "format": "wav"
  },
  "language": "de",
  "model": "mistralai/voxtral-mini-transcribe-3-0"
}

s4: object

Zu transkribierendes Audio als JSON im OpenRouter-Format. Die Audiodaten stehen Base64-kodiert in input_audio.

Vor jedem Provider-Aufruf wird der Anfrageinhalt validiert. Alle Probleme stehen in error.metadata.issues. Dekodiertes Audio darf höchstens 50 MiB groß sein und muss in den 50-MiB-Anfrageinhalt passen. Mit Base64 passen etwa 37 MiB Audio hinein. Größere Dateien als multipart/form-data hochladen. Unbekannte Parameter werden ignoriert und in x-ignored-params genannt.

{}

{
  "input_audio": {
    "data": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YQAAAAA=",
    "format": "wav"
  },
  "language": "de",
  "model": "openai/whisper-large-v3"
}
  • diarize (optional): s240

s240: boolean

Sprecherkennzeichnungen. Die Provider dieses Gateways unterstützen sie nicht. true scheitert mit 400 invalid_parameter.

{}

false
  • input_audio (Pflichtfeld): s241

s241: anyOf

Audio als {"data": <base64>, "format": <format>}. Formate: aac, flac, m4a, mp3, mp4, mpeg, mpga, oga, ogg, opus, wav, webm. {"url": …}, bei dem der Provider das Audio herunterlädt, wird von den Providern dieses Gateways nicht unterstützt und scheitert mit 400 invalid_parameter.

{}

anyOf: s201

s201: object

Audio als Base64.

{"additionalProperties":"false"}

{
  "data": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YQAAAAA=",
  "format": "wav"
}
  • data (Pflichtfeld): s982

s982: string

Base64-kodierte Audiodatei mit Standard- oder URL-sicherem Alphabet, ohne Daten-URL-Präfix.

{}

  • format (Pflichtfeld): s983

s983: string

Audioformat: aac, flac, m4a, mp3, mp4, mpeg, mpga, oga, ogg, opus, wav oder webm. Groß- und Kleinschreibung ist beliebig.

{"pattern":"\"^[a-zA-Z0-9][a-zA-Z0-9+._-]{0,15}$\""}

"wav"

anyOf: s202

s202: object

Audio, das der Provider herunterlädt. Die Provider dieses Gateways unterstützen dies nicht.

{"additionalProperties":"false"}

{
  "format": "mp3",
  "url": "https://example.com/meeting.mp3"
}
  • format (optional): s984

s984: string

Format der Audiodaten unter der URL.

{"pattern":"\"^[a-zA-Z0-9][a-zA-Z0-9+._-]{0,15}$\""}

"mp3"
  • url (Pflichtfeld): s985

s985: string

URL der Audiodatei. Scheitert mit 400 invalid_parameter.

uri

{"maxLength":"8000"}

  • keyterms (optional): s242

s242: array

Begriffe zur Beeinflussung der Erkennung. Von den Providern dieses Gateways nicht unterstützt. Eine nicht leere Liste scheitert mit 400 invalid_parameter. Solche Begriffe unter prompt angeben.

{}

s7: string

{}

  • language (optional): s243

s243: string

Audiosprache als ISO-639-1-Code, beispielsweise de. Ohne Angabe wird sie erkannt.

{}

"de"
  • metadata (optional): s244

s244: any

Lokale Metadaten: höchstens 16 Zeichenkettenpaare, Schlüssel mit 1 bis 64 und Werte mit 0 bis 512 Zeichen.

{}

  • model (Pflichtfeld): s245

s245: string

Transkriptionsmodell mit derselben ID wie bei OpenRouter oder einem Gateway-Alias. Modelle ohne Audiotranskription scheitern mit 404 no_endpoint. Eine unbekannte ID scheitert mit 400 model_not_found und einem Vorschlag unter remedy_hint.

{}

"openai/whisper-large-v3"
  • prompt (optional): s246

s246: string

Text zur Steuerung der Transkription, beispielsweise Namensschreibweisen oder der vorherige Teil einer längeren Aufnahme. Wird unverändert an den Provider weitergegeben.

{}

"Prozesshub, dpa"
  • provider (optional): s247

s247: object

Routing-Einstellungen wie bei Chat Completions: only, ignore, order, allow_fallbacks, sort und max_price. Werden nie an den Provider gesendet.

{}

  • response_format (optional): s248

s248: string

json ist der Standard und liefert text und usage. verbose_json ergänzt language, duration und zeitgestempelte segments.

"json", "verbose_json"

{}

"json"
  • session_id (optional): s249

s249: string | null

Groups related requests in generation records and GET /v1/sessions/{id}. Use 1 to 256 ASCII letters, digits, -, _, . or :; not only dots. A non-null body value takes precedence over x-session-id. Never sent to the provider.

{"minLength":"1","maxLength":"256"}

"session-1234"
  • temperature (optional): s250

s250: number

Sampling-Temperatur von 0 bis 1.

double

{}

0
  • timestamp_granularities (optional): s251

s251: array

Zeitstempeldetail bei verbose_json: segment und für ein Array words zusätzlich word.

{}

s215: string

Eine Zeitstempel-Detailstufe von verbose_json.

"word", "segment"

{}

"segment"
  • trace (optional): s252

s252: object

Ablaufmetadaten zur Beobachtbarkeit. Werden nie an den Provider gesendet.

{}

  • user (optional): s253

s253: string

Kennung des Endnutzers, die lokal gespeichert wird. Nur ein mandantenbezogener Hash darf an eine Route übermittelt werden, die user ausdrücklich unterstützt.

{"maxLength":"256"}

"user-1234"

Anfrageinhalt: multipart/form-data

{
  "file": "meeting.mp3",
  "language": "de",
  "model": "openai/whisper-large-v3"
}

s5: object

Zu transkribierendes Audio als Datei-Upload, wie ihn die OpenAI-SDKs senden.

{}

{
  "file": "meeting.mp3",
  "language": "de",
  "model": "openai/whisper-large-v3"
}
  • diarize (optional): s254

s254: boolean

Sprecherkennzeichnungen. true scheitert mit 400, da die Provider dieses Gateways sie nicht unterstützen.

{}

  • file (optional): s255

s255: string

Die erforderliche Audiodatei, höchstens 50 MiB. source_url wird nicht unterstützt. Das Format wird aus Dateiendung oder Content-Type des Parts ermittelt: aac, flac, m4a, mp3, mp4, mpeg, mpga, oga, ogg, opus, wav oder webm.

binary

{}

  • keyterms[] (optional): s256

s256: array

Begriffe zur Beeinflussung der Erkennung, ein Teil je Begriff. Von den Providern dieses Gateways nicht unterstützt (400).

{}

  • language (optional): s257

s257: string

Audiosprache als ISO-639-1-Code. Ohne Angabe wird sie erkannt.

{}

  • metadata (optional): s258

s258: string | null

Lokale Metadaten als JSON-Objekt mit höchstens 16 Zeichenkettenpaaren, Schlüsseln mit 1 bis 64 und Werten mit 0 bis 512 Zeichen. Sie werden nie an den Provider übermittelt.

{}

"{\"workflow\":\"support\"}"
  • model (Pflichtfeld): s259

s259: string

Transkriptionsmodell wie in der JSON-Form.

{}

"openai/whisper-large-v3"
  • prompt (optional): s260

s260: string

Text zur Steuerung der Transkription.

{}

  • provider (optional): s261

s261: string

Routing-Einstellungen als JSON-kodiertes Objekt.

{}

  • response_format (optional): s262

s262: string

json als Standard oder verbose_json.

"json", "verbose_json"

{}

"json"
  • session_id (optional): s263

s263: string

Groups related requests in generation records and GET /v1/sessions/{id}. Use 1 to 256 ASCII letters, digits, -, _, . or :; not only dots. This form field takes precedence over x-session-id. Never sent to the provider.

{"minLength":"1","maxLength":"256"}

  • source_url (optional): s264

s264: string

Audio-URL zum Herunterladen durch den Provider. Von den Providern dieses Gateways nicht unterstützt (400). Stattdessen die Datei hochladen.

uri

{}

  • temperature (optional): s265

s265: number

Sampling-Temperatur von 0 bis 1.

{}

  • timestamp_granularities[] (optional): s266

s266: array

Zeitstempeldetail bei verbose_json, ein Teil je Wert.

{}

Eine Zeitstempel-Detailstufe von verbose_json.

  • trace (optional): s267

s267: string

Ablaufmetadaten als JSON-kodiertes Objekt. Werden nie an den Provider gesendet.

{}

  • user (optional): s268

s268: string

Kennung des Endnutzers, die lokal gespeichert wird. Nur ein mandantenbezogener Hash darf an eine Route übermittelt werden, die user ausdrücklich unterstützt.

{"maxLength":"256"}

Antwort 200: application/json

Transkript mit den Provider-Zählwerten und EUR-Kosten unter usage.

{
  "text": "Guten Tag, hier ist die Zusammenfassung der Sitzung.",
  "usage": {
    "cost": 0.001,
    "currency": "EUR",
    "is_byok": false,
    "seconds": 9.2
  }
}

s6: object

Transkript im OpenRouter-Format mit EUR-Kosten.

{}

{
  "text": "Guten Tag, hier ist die Zusammenfassung der Sitzung.",
  "usage": {
    "cost": 0.001,
    "currency": "EUR",
    "is_byok": false,
    "seconds": 9.2
  }
}
  • text (Pflichtfeld): s269

s269: string

Transkribierter Text.

{}

"Guten Tag, hier ist die Zusammenfassung der Sitzung."
  • usage (optional): s270

s270: object

Provider-Zählwerte und EUR-Kosten, sofern Daten gemeldet wurden, auf die die Modellpreise anwendbar sind. Andernfalls fehlt cost, statt 0 zu sein.

{}

{
  "cost": 0.001,
  "currency": "EUR",
  "is_byok": false,
  "seconds": 9.2
}
  • cost (optional): s1003

s1003: number

Kosten der Anfrage in EUR. Tokens werden zu den Tokenpreisen des Modells berechnet, Audio zum Sekundenpreis. Angefangene Sekunden zählen vollständig.

double

{}

0.001
  • input_tokens (optional): s1004

s1004: integer

Eingabetokens, sofern der Provider Tokens zählt.

int64

{"minimum":"0"}

83
  • output_tokens (optional): s1005

s1005: integer

Ausgabetokens, sofern der Provider Tokens zählt.

int64

{"minimum":"0"}

30
  • seconds (optional): s1006

s1006: number

Audiodauer in Sekunden, sofern der Provider sie meldet.

double

{}

9.2
  • total_tokens (optional): s1007

s1007: integer

Eingabe- und Ausgabetokens zusammen.

int64

{"minimum":"0"}

113
  • * (optional): s1008

s1008: any

Öffentliche Felder: currency (immer EUR), is_byok und exakte cost_details. Unbekannte Provider-Nutzungsfelder werden entfernt.

{}

  • * (optional): s271

s271: any

Öffentliche OpenRouter-Transkriptionsfelder, beispielsweise language, duration, segments und words bei verbose_json. Eine optionale Erweiterung id wird weggelassen, wenn sie keine nicht leere Zeichenkette mit höchstens 128 Bytes ist oder die Zugangsdaten dieses Providers enthält, auch in kodierter Form.

{}

Antwort 400: application/json

Erkannte Upstream-Ablehnungen mit 400 oder 422 ergeben Client-Fehler ohne sinnvollen erneuten Versuch und mit sicheren öffentlichen Feldpfaden. Ungültige Anfrage: fehlerhaftes JSON oder ein fehlerhaftes Formular (invalid_request), ungültige Felder wie fehlendes oder nicht als Base64 vorliegendes Audio, ein nicht unterstütztes Audioformat oder nicht unterstützte Optionen mit allen Problemen unter issues (invalid_parameter), oder eine unbekannte Modell-ID mit Vorschlag unter remedy_hint (model_not_found).

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

s588: null

{}

  • 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 402: application/json

Das Ausgabenlimit des API-Schlüssels, das Arbeitsbereichsbudget (workspace_budget_exceeded) oder das vorausbezahlte Organisationsguthaben deckt die geschätzte Reservierung einschließlich Gebühren, Medien und gleichzeitiger Reservierungen nicht (insufficient_credits bei Schlüssel und Organisation). Ohne Reservierung beginnt kein kostenpflichtiger Upstream-Aufruf.

Antwort 403: application/json

Die Richtlinie der Organisation, des Arbeitsbereichs oder des Schlüssels erlaubt das Modell nicht (permission_denied); remedy_hint nennt die erlaubten Modelle

Antwort 404: application/json

Das Modell existiert, aber keiner seiner Provider passt zur Anfrage: keine Audiotranskription oder Ausschluss aller Provider durch provider-Filter beziehungsweise max_price. issues nennt die Ursache je Provider (no_endpoint).

Antwort 408: application/json

Der Provider hat innerhalb der Frist keine Verbindung aufgebaut oder seine Antwort nicht abgeschlossen, oder der Anfrageinhalt traf nicht weiter ein (timeout).

Antwort 409: application/json

idempotency_conflict: Der Key gehört zu anderem Anfrageinhalt; einen neuen Key verwenden. idempotency_in_progress: Der ursprüngliche Vorgang läuft noch; Retry-After beachten. idempotency_unavailable: Eine sichere Wiederholung ist nicht möglich; nicht still neu berechnen lassen. remedy_hint beachten.

Antwort 413: application/json

Der Anfrageinhalt oder das dekodierte Audio überschreitet 50 MiB (payload_too_large).

Antwort 429: application/json

Kundenkontingent oder Anfragelimit des Upstreams erschöpft (rate_limited)

Antwort 500: application/json

Unerwarteter Gateway-Fehler (internal)

Antwort 501: application/json

feature_unavailable: A required feature is permanently unconfigured on this gateway, for example encrypted idempotency replay without its encryption key, PII redaction without a detector, or BYOK import without import keys. Ask the operator to configure it or remove the optional feature from the request. Retrying the identical request cannot enable the feature: retryable is false and no Retry-After header is sent. Temporary cache, database, detector or provider outages, pending imports and missing or revoked individual customer credentials retain their existing error types.

Antwort 502: application/json

Der einzige versuchte Provider ist fehlgeschlagen (provider_error mit provider_name und strukturierten provider_error-Diagnosen, ohne Provider-Text) oder hat eine Antwort ohne text, über 32 MiB groß oder zu komplex zu parsen gesendet (provider_invalid_response).

Antwort 503: application/json

Alle Provider fehlgeschlagen, Gateway durch andere große Anfrageinhalte ausgelastet oder diese Gateway-Instanz wird beendet (no_provider_available).