# Statuscodes

> HTTP-Statuscodes und Antwortformate der WayinVideo API.

## Statuscodes

Die API verwendet Standard-HTTP-Statuscodes.

---

## 200 OK

Die Anfrage war erfolgreich. Der Antworttext ist JSON mit dem Payload in `data`.

```json
{"data": {"project_id": "prj06928fdjqqaza", "name": "Sample project name", "status": "SUCCEEDED"}}
```

---

## 400 Bad Request

Clientseitiger Fehler — ungültige Parameter, nicht unterstütztes Videoformat oder andere Eingabeprobleme. Überprüfen Sie das `message`-Feld, korrigieren Sie die Anfrage und versuchen Sie es erneut.

| Feld | Typ | Beschreibung |
|------|-----|--------------|
| `trace_id` | string | Eindeutige Kennung für Diagnose und Support |
| `message` | string | Menschenlesbare Fehlerbeschreibung |

```json
{"message": "the error message", "trace_id": "the_trace_id"}
```

---

## Nicht genügend API-Einheiten

Wenn das Konto nicht genügend API-Einheiten für die Aufgabe hat, antwortet die API mit **400 Bad Request**. Es wird keine Aufgabe erstellt und keine Einheit abgezogen. Der Body enthält `message` und `trace_id`.

```json
{
  "message": "Your API units are insufficient. Please purchase more to continue: https://wayin.ai/wayinvideo/api-dashboard",
  "trace_id": "the_trace_id"
}
```

Tarife stehen auf der Seite [Abrechnung](https://wayin.ai/de/api-docs/pricing/).

---

## 500 Internal Server Error

Serverseitiger Fehler. Wenn das Problem anhält, kontaktieren Sie den Support mit der `trace_id`.

```json
{"message": "the error message", "trace_id": "the_trace_id"}
```

---

## 403 Forbidden

Authentifizierung fehlgeschlagen. Die Antwort enthält: `timestamp`, `status`, `error`, `path`.

```json
{"timestamp": "2026-03-13T07:58:46.156+00:00", "status": 403, "error": "Forbidden", "path": "/api/v2/clips"}
```

---

## 429 Too Many Requests

Anfragelimit oder Parallelverarbeitungslimit überschritten. Gleiches Format wie 403.

```json
{"timestamp": "2026-03-10T15:52:01.610+00:00", "status": 429, "error": "Too Many Requests", "path": "/api/v2/clips/results/prjxxx"}
```

Weitere Informationen finden Sie unter [Anfragelimits](https://wayin.ai/de/api-docs/rate-limits/).