> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.kontinent.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.kontinent.ai/_mcp/server.

# Fehler

Fehler haben immer die OpenAI-Form:

```json
{ "error": { "message": "…", "type": "…", "code": "…" } }
```

## Statusreferenz

| HTTP | `code`                  | `type`                  | Bedeutung / Client-Aktion                                            |
| ---- | ----------------------- | ----------------------- | -------------------------------------------------------------------- |
| 400  | `invalid_request`       | `invalid_request_error` | Fehlerhafter Body, über 2 MiB oder fehlendes `model`.                |
| 401  | `invalid_api_key`       | `invalid_request_error` | Ungültiger oder widerrufener Schlüssel — **nicht erneut versuchen**. |
| 402  | `insufficient_credits`  | `insufficient_quota`    | Guthaben ≤ 0 — aufladen, dann erneut versuchen.                      |
| 404  | `model_not_found`       | `invalid_request_error` | Unbekannte oder deaktivierte Modell-ID.                              |
| 429  | `rate_limit_exceeded`   | `rate_limit_error`      | RPM pro Schlüssel erreicht — Backoff (gleitendes 60-s-Fenster).      |
| 429  | `upstream_rate_limited` | `rate_limit_error`      | Anbieter hat uns gedrosselt — mit Backoff erneut versuchen.          |
| 500  | `internal_error`        | `api_error`             | Gateway-Bug — wiederholbar.                                          |
| 502  | `upstream_auth_error`   | `api_error`             | Anbieter hat **unsere** Anmeldedaten abgelehnt — unser Problem.      |
| 502  | `upstream_error`        | `api_error`             | Anbieter-5xx / Verbindungsfehler — wiederholbar.                     |

## Durchgereichte Fehler

Upstream-4xx-Bodies, die bereits die OpenAI-Form haben (z. B. anbieterseitige
Validierung Ihrer Parameter), werden **mit ihrem ursprünglichen Status
durchgereicht** statt neu verpackt.

## Hinweise zum erneuten Versuch

#### Wiederholbar

`429`, `500`, `502 upstream_error`. Nutzen Sie exponentiellen Backoff mit
Jitter.

#### So nicht wiederholbar

`400`, `401`, `404`. Beheben Sie zuerst die Anfrage oder den Schlüssel.
`402` ist nur nach einer Aufladung wiederholbar.