Typisierte Fragen beantworten

TypeSafe-compatible noul, choice and score questions. One to 64 questions, 2 to 255 choice options, 1 to 10 ordered score levels. State and descriptions may be text, objects or arrays, within the shared 50 MiB body and structure limits. No streaming or media assets. Box questions are recognized but rejected as unavailable before provider I/O, including in mixed requests. Probabilities retain their native values. Input/output counts are reported by the provider; additional cost and currency fields use exact EUR pricing. Unknown model IDs return catalog not_found (404) with issues and a suggestion; mixed validation failures remain invalid_parameter (400). Unknown request fields are ignored; unknown provider response fields are discarded. Identity and bounded Zstd request compression are supported, including the official TypeSafe Python SDK default. Body session_id overrides x-session-id. Opted-in capture stores the request envelope as the sole input.messages entry, and the serialized decision response under the existing bounded content policy.

Administrative PII requirements are checked for each actual route, including fallbacks and retries. This endpoint cannot redact its input: a matching requirement returns invalid_parameter with a not_available issue at $.model before provider I/O.

Im öffentlichen Katalog ist derzeit kein geeignetes Beispielmodell bestätigt. YOUR_MODEL_ID vor dem Senden durch ein verfügbares Modell für diesen Endpunkt ersetzen.

POST https://api.tokenlane.de/v1/systemone

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 POST \
  --url 'https://api.tokenlane.de/v1/systemone' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "YOUR_MODEL_ID",
  "questions": {
    "refund": {
      "instructions": "Is a refund requested?",
      "type": "noul"
    }
  },
  "state": {
    "ticket": "Please refund the duplicate charge."
  }
}'

node

const response = await fetch("https://api.tokenlane.de/v1/systemone", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Content-Type": "application/json",
  },
  body: `{
  "model": "YOUR_MODEL_ID",
  "questions": {
    "refund": {
      "instructions": "Is a refund requested?",
      "type": "noul"
    }
  },
  "state": {
    "ticket": "Please refund the duplicate charge."
  }
}`,
});
console.log(await response.text());

python

import os
import urllib.request

body = (r'''{
  "model": "YOUR_MODEL_ID",
  "questions": {
    "refund": {
      "instructions": "Is a refund requested?",
      "type": "noul"
    }
  },
  "state": {
    "ticket": "Please refund the duplicate charge."
  }
}''').encode("utf-8")

request = urllib.request.Request(
    "https://api.tokenlane.de/v1/systemone",
    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/systemone", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Content-Type": "application/json",
  },
  body: `{
  "model": "YOUR_MODEL_ID",
  "questions": {
    "refund": {
      "instructions": "Is a refund requested?",
      "type": "noul"
    }
  },
  "state": {
    "ticket": "Please refund the duplicate charge."
  }
}`,
});
console.log(await response.text());

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.

s0: string | null

{}

Anfrageinhalt: application/json

{
  "model": "YOUR_MODEL_ID",
  "questions": {
    "refund": {
      "instructions": "Is a refund requested?",
      "type": "noul"
    }
  },
  "state": {
    "ticket": "Please refund the duplicate charge."
  }
}

s36: object

Evaluate up to 64 questions in one non-streaming inference call. Box questions are recognized but rejected as unavailable before provider I/O.

{}

{
  "model": "Qwen/Qwen3.5-2B",
  "questions": {
    "refund": {
      "instructions": "Is a refund requested?",
      "type": "noul"
    }
  },
  "state": {
    "ticket": "Please refund the duplicate charge."
  }
}
  • model (Pflichtfeld): s397

s397: string

Öffentliche Entscheidungsmodell-ID oder Alias. Auch mit dem TypeSafe SDK erforderlich.

{}

"Qwen/Qwen3.5-2B"
  • provider (optional): s398

s398: object

Provider-Auswahl und Datenanforderungen. Werden nie an den Upstream weitergegeben.

{}

  • questions (Pflichtfeld): s399

s399: object

JSON object mapping names to entries of the declared value type.

{}

  • * (optional): s1078

s1078: oneOf

Eine benannte Entscheidungsfrage. Wahrscheinlichkeitsantworten verwenden denselben Namen und Typ.

{}

{
  "criteria": {
    "billing": "Payments",
    "support": "Technical issues"
  },
  "instructions": "Which team?",
  "type": "choice"
}

oneOf: s1266

s1266: object

Probability that a statement is true.

{}

  • criteria (optional): s608

s608: object | null

Optionale Beschreibungen der beiden Ergebnisse einer Ja/Nein-Frage.

{}

  • false (optional): s1149

s1149: anyOf

Text or structured guidance; null leaves it unspecified.

{}

anyOf: s7

s7: string

{}

anyOf: s1287

s1287: object

{}

  • * (optional): s1339

s1339: any

{}

anyOf: s1288

s1288: array

{}

s1340: any

{}

anyOf: s588

s588: null

{}

  • true (optional): s1150

s1150: anyOf

Text or structured guidance; null leaves it unspecified.

{}

anyOf: s7

anyOf: s1289

s1289: object

{}

  • * (optional): s1341

s1341: any

{}

anyOf: s1290

s1290: array

{}

s1342: any

{}

anyOf: s588

  • instructions (optional): s609

s609: anyOf

Text or structured guidance; null leaves it unspecified.

{}

anyOf: s7

anyOf: s1151

s1151: object

{}

  • * (optional): s1291

s1291: any

{}

anyOf: s1152

s1152: array

{}

s1292: any

{}

anyOf: s588

  • type (Pflichtfeld): s610

s610: string

Always noul.

"noul"

{}

oneOf: s1267

s1267: object

Select one of the named alternatives.

{}

  • criteria (Pflichtfeld): s603

s603: object

JSON object mapping names to entries of the declared value type.

{}

  • * (optional): s1146

s1146: anyOf

Text or structured guidance; null leaves it unspecified.

{}

anyOf: s7

anyOf: s1283

s1283: object

{}

  • * (optional): s1337

s1337: any

{}

anyOf: s1284

s1284: array

{}

s1338: any

{}

anyOf: s588

  • instructions (optional): s604

s604: anyOf

Text or structured guidance; null leaves it unspecified.

{}

anyOf: s7

anyOf: s1147

s1147: object

{}

  • * (optional): s1285

s1285: any

{}

anyOf: s1148

s1148: array

{}

s1286: any

{}

anyOf: s588

  • type (Pflichtfeld): s605

s605: string

Always choice.

"choice"

{}

oneOf: s1268

s1268: object

Rate the state against ordered levels.

{}

  • criteria (Pflichtfeld): s616

s616: array

Ordered descriptions of one to ten levels, lowest first.

{"minItems":"1","maxItems":"10"}

s1154: anyOf

Text oder strukturierter Kontext. Verschachtelte JSON-Werte behalten ihre ursprüngliche Darstellung.

{}

anyOf: s7

anyOf: s1295

s1295: object

{}

  • * (optional): s1345

s1345: any

{}

anyOf: s1296

s1296: array

{}

s1346: any

{}

  • instructions (optional): s617

s617: anyOf

Text or structured guidance; null leaves it unspecified.

{}

anyOf: s7

anyOf: s1155

s1155: object

{}

  • * (optional): s1297

s1297: any

{}

anyOf: s1156

s1156: array

{}

s1298: any

{}

anyOf: s588

  • type (Pflichtfeld): s618

s618: string

Always score.

"score"

{}

oneOf: s1269

s1269: object

Recognized vendor image bounding-box syntax; execution is unavailable.

{}

  • instructions (Pflichtfeld): s597

s597: anyOf

Text oder strukturierter Kontext. Verschachtelte JSON-Werte behalten ihre ursprüngliche Darstellung.

{}

anyOf: s7

anyOf: s1144

s1144: object

{}

  • * (optional): s1281

s1281: any

{}

anyOf: s1145

s1145: array

{}

s1282: any

{}

  • type (Pflichtfeld): s598

s598: string

Always box.

"box"

{}

  • session_id (optional): s400

s400: string

Lokale Session-Kennung. Hat Vorrang vor dem Header x-session-id.

{}

"support-42"
  • state (Pflichtfeld): s401

s401: anyOf

Text oder strukturierter Kontext. Verschachtelte JSON-Werte behalten ihre ursprüngliche Darstellung.

{}

anyOf: s7

anyOf: s1079

s1079: object

{}

  • * (optional): s1270

s1270: any

{}

anyOf: s1080

s1080: array

{}

s1271: any

{}

Antwort 200: application/json

Typisierte Antworten und exakte EUR-Nutzungsdaten. x-generation-id kennzeichnet die gespeicherte Entscheidungs-Generierung.

{
  "answers": {
    "refund": {
      "noul": 0.95,
      "type": "noul"
    }
  },
  "id": "gen-01k7tm9qz3f5c8x2v6b4n0m7hd",
  "model": "Qwen/Qwen3.5-2B",
  "usage": {
    "cost": 0.00000504,
    "currency": "EUR",
    "input_tokens": 120,
    "output_tokens": 12
  }
}

s37: object

TypeSafe-Antwortstruktur mit zusätzlicher Gateway-Generierungs-ID und EUR-Nutzungsdaten.

{}

{
  "answers": {
    "refund": {
      "noul": 0.95,
      "type": "noul"
    }
  },
  "id": "gen-01k7tm9qz3f5c8x2v6b4n0m7hd",
  "model": "Qwen/Qwen3.5-2B",
  "usage": {
    "cost": 0.00000504,
    "currency": "EUR",
    "input_tokens": 120,
    "output_tokens": 12
  }
}
  • answers (Pflichtfeld): s402

s402: object

JSON object mapping names to entries of the declared value type.

{}

  • * (optional): s1081

s1081: oneOf

Eine Entscheidung mit den ursprünglichen numerischen Provider-Wahrscheinlichkeiten ohne Neuskalierung.

{}

{
  "noul": 0.95,
  "type": "noul"
}

oneOf: s1272

s1272: object

Wahrscheinlichkeit einer wahren Aussage.

{}

  • noul (Pflichtfeld): s606

s606: number

Endliche Wahrscheinlichkeit zwischen null und eins.

double

{"minimum":"0","maximum":"1"}

0.95
  • type (Pflichtfeld): s607

s607: string

Always noul.

"noul"

{}

oneOf: s1273

s1273: object

Eine ausgewählte Alternative mit ihrer Verteilung.

{}

  • choice (Pflichtfeld): s599

s599: string

Name einer angeforderten Alternative mit maximaler Wahrscheinlichkeit.

{}

"billing"
  • confidence (Pflichtfeld): s600

s600: number

Endliche Konfidenz zwischen null und eins.

double

{"minimum":"0","maximum":"1"}

0.9
  • probabilities (Pflichtfeld): s601

s601: object

JSON object mapping names to entries of the declared value type.

{}

  • * (optional): s24

s24: number

double

{}

  • type (Pflichtfeld): s602

s602: string

Always choice.

"choice"

{}

oneOf: s1274

s1274: object

Eine mit Wahrscheinlichkeiten gewichtete, bei null beginnende Stufe.

{}

  • confidence (Pflichtfeld): s611

s611: number

Endliche Konfidenz zwischen null und eins.

double

{"minimum":"0","maximum":"1"}

0.8
  • legend (Pflichtfeld): s612

s612: object

Decimal zero-based level indices mapped to the original level descriptions.

{}

  • * (optional): s1153

s1153: anyOf

Text oder strukturierter Kontext. Verschachtelte JSON-Werte behalten ihre ursprüngliche Darstellung.

{}

anyOf: s7

anyOf: s1293

s1293: object

{}

  • * (optional): s1343

s1343: any

{}

anyOf: s1294

s1294: array

{}

s1344: any

{}

  • probabilities (Pflichtfeld): s613

s613: object

JSON object mapping names to entries of the declared value type.

{}

  • * (optional): s24
  • score (Pflichtfeld): s614

s614: number

Endlicher Wert von null bis zum Index der letzten Stufe. Nachkommastellen sind möglich.

double

{"minimum":"0"}

1.7
  • type (Pflichtfeld): s615

s615: string

Always score.

"score"

{}

  • id (Pflichtfeld): s403

s403: string

Generierungs-ID des Gateways. Wird auch unter x-generation-id zurückgegeben.

{}

"gen-01k7tm9qz3f5c8x2v6b4n0m7hd"
  • model (Pflichtfeld): s404

s404: string

Aufgelöste öffentliche Modell-ID.

{}

"Qwen/Qwen3.5-2B"
  • usage (Pflichtfeld): s405

s405: object

Native Zählwerte und exakte EUR-Kosten.

{}

{
  "cost": 0.00000504,
  "currency": "EUR",
  "input_tokens": 120,
  "output_tokens": 12
}
  • cost (Pflichtfeld): s593

s593: number

Exakter EUR-Betrag aus der Ganzzahl-Abrechnung in Pico-Einheiten.

double

{}

0.00000504
  • currency (Pflichtfeld): s594

s594: string

Kundenwährung. Immer EUR.

{}

"EUR"
  • input_tokens (Pflichtfeld): s595

s595: integer

Gemeldete Eingabetokens. Geschätzte Werte bestimmen nie die Rechnung.

int64

{"minimum":"0"}

120
  • output_tokens (Pflichtfeld): s596

s596: integer

Gemeldete Ausgabetokens, auch wenn das Modellprofil sie mit einem Preis von 0 bewertet.

int64

{"minimum":"0"}

12

Antwort 400: application/json

Erkannte Upstream-Ablehnungen mit 400 oder 422 sind Client-Fehler ohne sinnvollen erneuten Versuch. Ungültiges JSON, ungültige Felder mit gesammelten Issues oder überschrittene Kontextgrenze.

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

Antwort 402: application/json

Guthaben des Keys oder der Organisation reicht für die begrenzte Reservierung nicht aus.

Antwort 403: application/json

Die Richtlinie der Organisation, des Arbeitsbereichs oder des Schlüssels verbietet dieses Modell

Antwort 404: application/json

Unbekanntes Modell oder keine zulässige Entscheidungsroute. metadata.issues und remedy_hint erläutern die Abhilfe.

Antwort 408: application/json

Zeitüberschreitung beim Hochladen der Anfrage oder bei der Upstream-Antwort

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

Anfrageinhalt oder geparstes JSON überschreitet die Speichergrenze.

Antwort 429: application/json

Anfragelimit des Kunden oder Providers erreicht. Retry-After nennt die Wartezeit in Sekunden.

Antwort 500: application/json

Unerwarteter Gateway-Fehler

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

Sicher aufbereiteter Provider-Fehler oder ungültige Entscheidungs- beziehungsweise Nutzungsantwort

Antwort 503: application/json

Provider fehlgeschlagen, Speicher ausgelastet oder Gateway wird beendet