Antwort erstellen
Akzeptiert Text oder eine vollständige Unterhaltung unter input und übersetzt sie für den ausgewählten Provider in Chat Completions. Normale Antworten enthalten message-, reasoning- und function_call-Ausgabeelemente. Streams senden typisierte Lebenszyklusereignisse und Ausgabedeltas unmittelbar mit der Upstream-Ausgabe, gefolgt von Done-Ereignissen und response.completed oder response.incomplete, dann [DONE]. Ein Fehler nach dem ersten Byte beendet den Stream mit response.failed und Katalogmetadaten unter response.error. HTTP-Fehler vor dem Streaming verwenden die normale Fehlerstruktur.
Routing, EUR-Abrechnung, Key-Regeln, Inhaltsaufzeichnung und Session-/Ablaufaufzeichnung werden mit Chat Completions geteilt. Eine abgeschlossene Antwort wird gespeichert, bevor das finale Ereignis gesendet wird. Es wird kein Antwortzustand für previous_response_id gespeichert. Der vollständige Verlauf muss in input stehen.
POST https://api.tokenlane.de/v1/responses
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/responses' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"input": "What is the capital of Portugal?",
"instructions": "Answer in one sentence.",
"max_output_tokens": 400,
"model": "deepseek/deepseek-v4-flash-0731"
}'
node
import OpenAI from 'openai';
const client = new OpenAI({ baseURL: "https://api.tokenlane.de/v1", apiKey: process.env.TOKENLANE_API_KEY });
const response = await client.responses.create({
"input": "What is the capital of Portugal?",
"instructions": "Answer in one sentence.",
"max_output_tokens": 400,
"model": "deepseek/deepseek-v4-flash-0731"
}, {});
console.log(response);
python
import os
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.tokenlane.de/v1", api_key=os.environ["TOKENLANE_API_KEY"])
body = json.loads(r'''{
"input": "What is the capital of Portugal?",
"instructions": "Answer in one sentence.",
"max_output_tokens": 400,
"model": "deepseek/deepseek-v4-flash-0731"
}''')
response = client.responses.create(
model=body["model"],
input=body["input"],
instructions=body["instructions"],
max_output_tokens=body["max_output_tokens"]
)
print(response)
vercel
// This operation uses HTTP directly.
const response = await fetch("https://api.tokenlane.de/v1/responses", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
"Content-Type": "application/json",
},
body: `{
"input": "What is the capital of Portugal?",
"instructions": "Answer in one sentence.",
"max_output_tokens": 400,
"model": "deepseek/deepseek-v4-flash-0731"
}`,
});
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
{}
Header: x-session-id (optional)
Session-ID, sofern session_id nicht im Anfrageinhalt steht. Es gelten dieselben Grenzen wie bei Chat Completions.
Anfrageinhalt: application/json
{
"input": "What is the capital of Portugal?",
"instructions": "Answer in one sentence.",
"max_output_tokens": 400,
"model": "deepseek/deepseek-v4-flash-0731"
}
s32: object
Ein zustandsloser Responses-Aufruf, der für das ausgewählte Modell in Chat Completions übersetzt wird. input ist Text oder eine Unterhaltung aus message-, reasoning-, function_call- und function_call_output-Elementen. Nachrichten unterstützen input_text, output_text, input_image, input_file, input_audio und input_video. Funktions-Tools und Auswahl verwenden die flache Responses-Struktur ({"type":"function","name":"get_weather","parameters":{...}}). text.format wählt text, json_object oder json_schema. max_output_tokens begrenzt die Generierung. Routing, Regeln, EUR-Kosten, Begründungseinstellungen, Sessions und Plugins folgen der Chat-API.
Dieser Endpunkt speichert keinen Antwortzustand. previous_response_id, aktiviertes background/store, gespeicherte Prompts, undurchsichtige Begründungen, Server-Tool-Schemata und include-Erweiterungen scheitern mit not_available-Issues. Der vollständige Verlauf muss in input stehen. Automatisches Kürzen und das Generieren von Ausgabemedien sind nicht verfügbar. Unbekannte Felder auf oberster Ebene werden in x-ignored-params genannt.
{}
{
"input": "What is the capital of Portugal?",
"instructions": "Answer in one sentence.",
"max_output_tokens": 400,
"model": "deepseek/deepseek-v4.1-flash"
}
- model (optional): s372
s372: string | null
Öffentliche Modell-ID oder Gateway-Alias. Erforderlich, sofern models keine Fallbacks auflistet.
{}
"deepseek/deepseek-v4.1-flash"
- stream (optional): s373
s373: boolean | null
Streamt typisierte Ereignisse wie response.created, Ausgabeelemente, Teile, Deltas, Done- und Abschlussereignisse.
{}
false
- * (optional): s374
s374: any
Responses-Parameter einschließlich input (Zeichenkette oder Array unterschiedlicher Eingabeelemente), instructions, tools, max_output_tokens und der oben genannten Generierungs- und Routing-Optionen. Eingabeelemente behalten Provider-Erweiterungen. Das Gateway prüft ihre bekannten Felder.
{}
Antwort 200: application/json
Responses-Antwortstruktur oder typisierte SSE-Ereignisse mit Abschluss [DONE]. Kosten sind in EUR angegeben. Ausgaben werden für Done- und Completed-Ereignisse nur innerhalb des gemeinsamen Antwortbudgets von höchstens 32 MiB vorgehalten. Deltas werden sofort gestreamt. Überlastung, ungültige Upstream-Ausgaben und Verbindungsabbrüche geben die Upstream-Anfrage frei.
{
"completed_at": 1792417001,
"created_at": 1792417000,
"error": null,
"frequency_penalty": 0,
"id": "gen-019a-abc",
"incomplete_details": null,
"instructions": null,
"metadata": {},
"model": "deepseek/deepseek-v4.1-flash",
"object": "response",
"output": [
{
"content": [
{
"annotations": [],
"logprobs": [],
"text": "Lisbon.",
"type": "output_text"
}
],
"id": "msg_019a_0",
"role": "assistant",
"status": "completed",
"type": "message"
}
],
"parallel_tool_calls": true,
"presence_penalty": 0,
"status": "completed",
"temperature": 1,
"tool_choice": "auto",
"tools": [],
"top_p": 1
}
s33: object
Die Antwortstruktur. Die Ausgabe enthält Nachrichtenelemente mit output_text- oder refusal-Inhalt, Begründungselemente mit reasoning_text-Inhalt und function_call-Elemente. Fehlen Begründung oder Nutzung beim Upstream, werden keine Angaben erfunden. Die Antwort-ID ist zugleich die ID zum Abrufen der Generierung.
{}
{
"completed_at": 1792417001,
"created_at": 1792417000,
"error": null,
"frequency_penalty": 0,
"id": "gen-019a-abc",
"incomplete_details": null,
"instructions": null,
"metadata": {},
"model": "deepseek/deepseek-v4.1-flash",
"object": "response",
"output": [
{
"content": [
{
"annotations": [],
"logprobs": [],
"text": "Lisbon.",
"type": "output_text"
}
],
"id": "msg_019a_0",
"role": "assistant",
"status": "completed",
"type": "message"
}
],
"parallel_tool_calls": true,
"presence_penalty": 0,
"status": "completed",
"temperature": 1,
"tool_choice": "auto",
"tools": [],
"top_p": 1
}
- completed_at (optional): s375
s375: integer | null
Abschlusszeitpunkt in Unix-Sekunden. Null während der Verarbeitung oder nach einem Fehler.
int64
{}
- created_at (Pflichtfeld): s376
s376: integer
Erstellungszeitpunkt der Anfrage in Unix-Sekunden.
int64
{}
- error (optional): s377
s377: any
Fehlerinformationen mit Katalogmetadaten des Gateways. Andernfalls null.
{}
- frequency_penalty (optional): s378
s378: number | null
Wirksame Häufigkeitsstrafe. Standardwert 0.
double
{}
- id (Pflichtfeld): s379
s379: string
Generierungs-ID des Gateways. Wird auch unter x-generation-id zurückgegeben.
{}
- incomplete_details (optional): s380
s380: any
Grund einer unvollständigen Generierung: max_output_tokens oder content_filter. Andernfalls null.
{}
- instructions (optional): s381
s381: string | null
Aus der Anfrage übernommener Anweisungstext. Andernfalls null.
{}
- metadata (Pflichtfeld): s382
s382: object
Metadaten des Aufrufers. Standardmäßig ein leeres Objekt.
{}
- * (optional): s1075
s1075: any
{}
- model (Pflichtfeld): s383
s383: string
Nach Aliasauflösung und Fallbacks tatsächlich ausgewähltes Modell.
{}
- object (Pflichtfeld): s384
s384: string
Immer response.
"response"
{}
- output (Pflichtfeld): s385
s385: array
Geordnete Ausgabeelemente mit stabilen IDs und ihrem Inhalt oder ihren Funktionsargumenten.
{}
s1076: any
{}
- parallel_tool_calls (Pflichtfeld): s386
s386: boolean
Ob parallele Funktionsaufrufe erlaubt waren. Standardwert true.
{}
- presence_penalty (optional): s387
s387: number | null
Wirksame Präsenzstrafe. Standardwert 0.
double
{}
- status (Pflichtfeld): s388
s388: string
completed, incomplete, in_progress oder failed. Eine erschöpfte Tokenmenge ergibt incomplete.
{}
- temperature (optional): s389
s389: number | null
Wirksame Sampling-Temperatur. Standardwert 1.
double
{}
- tool_choice (Pflichtfeld): s390
s390: any
Wirksame Tool-Auswahl. Standardwert auto.
{}
- tools (Pflichtfeld): s391
s391: array
Funktions-Tool-Definitionen im Responses-Format. Standardmäßig eine leere Liste.
{}
s1077: any
{}
- top_p (optional): s392
s392: number | null
Wirksamer Parameter für Nucleus-Sampling. Standardwert 1.
double
{}
- usage (optional): s393
s393: any
Tokenzahlen mit input_tokens/output_tokens und Details. Kosten sind in EUR angegeben, einschließlich ursprünglicher Währung und Wechselkursmetadaten bei Providern mit Preisen in anderer Währung.
{}
- * (optional): s394
s394: any
Weitere wirksame Optionen wie max_output_tokens, text, reasoning und store.
{}
Antwort 200: text/event-stream
Responses-Antwortstruktur oder typisierte SSE-Ereignisse mit Abschluss [DONE]. Kosten sind in EUR angegeben. Ausgaben werden für Done- und Completed-Ereignisse nur innerhalb des gemeinsamen Antwortbudgets von höchstens 32 MiB vorgehalten. Deltas werden sofort gestreamt. Überlastung, ungültige Upstream-Ausgaben und Verbindungsabbrüche geben die Upstream-Anfrage frei.
event: response.output_text.delta
data: {"content_index":0,"delta":"Lisbon","item_id":"msg_019a_0","logprobs":[],"output_index":0,"sequence_number":4,"type":"response.output_text.delta"}
s34: object
Ein Server-Sent Event, dessen JSON-Inhalt im Datenstrom auf data: folgt. Der Stream verwendet event: für den Ereignistyp und endet mit dem nicht als JSON formatierten Abschluss data: [DONE].
{}
{
"data": {
"content_index": 0,
"delta": "Lisbon",
"item_id": "msg_019a_0",
"logprobs": [],
"output_index": 0,
"sequence_number": 4,
"type": "response.output_text.delta"
}
}
- data (Pflichtfeld): s395
s395: object
Typisiertes Lebenszyklus- oder Ausgabeereignis innerhalb des SSE-Frames.
{}
{
"content_index": 0,
"delta": "Lisbon",
"item_id": "msg_019a_0",
"logprobs": [],
"output_index": 0,
"sequence_number": 4,
"type": "response.output_text.delta"
}
- sequence_number (Pflichtfeld): s971
s971: integer
Monoton steigende Ereignisnummer, beginnend bei null.
int64
{"minimum":"0"}
- type (Pflichtfeld): s972
s972: string
Name des Lebenszyklus- oder Ausgabeereignisses. Steht auch im SSE-Ereignisfeld.
{}
- * (optional): s973
s973: any
Ereignisinhalt: Antwort, Element, Teil, Delta oder vollständiger Text beziehungsweise vollständige Argumente, mit Indizes und IDs.
{}
Antwort 400: application/json
Erkannte Upstream-Ablehnungen mit 400 oder 422 sind Client-Fehler ohne sinnvollen erneuten Versuch. Ungültiges JSON, ungültige Parameter mit allen Issues an den ursprünglichen Eingabepfaden, unbekanntes Modell oder überschrittene Kontextlänge. Nicht unterstützte zustandsbehaftete Optionen und Server-Tools erhalten not_available-Issues.
{
"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"
]
s7: string
{}
- 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
Fehlender, ungültiger oder abgelaufener API-Key.
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 verbietet das angefragte Modell oder die Schlüsselrichtlinie das Server-Tool.
Antwort 404: application/json
Keine Route unterstützt das angeforderte Modell, die Modalitäten, Parameter oder Provider-Einstellungen.
Antwort 408: application/json
Zeitüberschreitung beim Hochladen, Upstream-Verbindungsaufbau, ersten Byte oder bei der vollständigen 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
Der Anfrageinhalt überschreitet 50 MiB oder die JSON-Struktur ohne JSON-Zeichenkettenwerte überschreitet 20 MiB.
Antwort 429: application/json
Kundenkontingent oder Anfragelimit des Providers erreicht. Nach der angegebenen Wartezeit erneut versuchen.
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
Provider-Fehler, ungültige oder übermäßig große Ausgabe.
Antwort 503: application/json
Kein Provider hat geantwortet, ein Wechselkurs fehlt, Speicher oder Generierungswarteschlange sind erschöpft oder das Herunterfahren läuft.