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.