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