# 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
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

```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

```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

```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

```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.

{}

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

{}

```json
"deepseek/deepseek-v4.1-flash"
```

- stream (optional): s373

### s373: boolean | null

Streamt typisierte Ereignisse wie response.created, Ausgabeelemente, Teile, Deltas, Done- und Abschlussereignisse.

{}

```json
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.

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

{}

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

```text
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]`.

{}

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

{}

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

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

{}

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

{}

```json
{
  "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"}

```json
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.

{}

```json
"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.

{}

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

{}

```json
[
  "deepinfra",
  "open-inference"
]
```

### s7: string

{}

- docs_url (Pflichtfeld): s640

### s640: string

Link zum Abschnitt dieses Fehlertyps in der Dokumentation.

{}

```json
"/docs#description/model-not-found"
```

- failed_routing_step (optional): s641

### s641: string

Routing-Schritt, nach dem keine Route übrig blieb. Nur bei Routing-Fehlern.

{}

```json
"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.

{}

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

{}

```json
"out_of_range"
```

- message (Pflichtfeld): s637

### s637: string

Problembeschreibung auf Englisch mit dem Feld und, sofern kurz, dem gesendeten Wert.

{}

```json
"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.

{}

```json
"$.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.

{}

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

{}

```json
"rate_limited"
```

- code (optional): s1300

### s1300: string

Exakte Kennung aus der festen Liste des konfigurierten Dialekts. Beliebige andere Werte werden entfernt.

{}

```json
"rate_limit_exceeded"
```

- provider_name (Pflichtfeld): s1301

### s1301: string

Konfigurierter Provider-Name. Nie ein Name aus dem Upstream-Antwortinhalt.

{}

```json
"deepinfra"
```

- retry_after (optional): s1302

### s1302: integer

Begrenzte Wartezeit in Sekunden aus dem Upstream-Header Retry-After, sofern vorhanden und numerisch.

int64

{"minimum":"0"}

```json
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"}

```json
429
```

oneOf: s588

### s588: null

{}

- provider_name (optional): s644

### s644: string

Fehlgeschlagener Provider wie im Antwortfeld `provider`. Nur bei Provider-Fehlern.

{}

```json
"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.

{}

```json
""
```

- remedy_hint (optional): s646

### s646: string

Ein konkreter Lösungsvorschlag, beispielsweise die ähnlichste Modell-ID bei einem Tippfehler.

{}

```json
"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.

{}

```json
"req_01k7tm9qz3f5c8x2v6b4n0m7hd"
```

- requested_providers (optional): s648

### s648: array

Unter `provider.only` genannte Provider, wenn dadurch alle Routen ausgeschlossen wurden.

{}

```json
[
  "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"}

```json
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.

{}

```json
{
  "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"}

```json
2
```

- reason (optional): s980

### s980: string

Anfragefeld, nach dem der Schritt gefiltert hat.

{}

```json
"provider.only"
```

- step (Pflichtfeld): s981

### s981: string

Name des Schritts wie bei OpenRouter.

{}

```json
"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"

{}

```json
"invalid_parameter"
```

- user_id (optional): s239

### s239: string | null

Organisation des API-Keys, sofern der Key erkannt wurde.

{}

```json
"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.
