# Códigos de Estado

> Códigos de estado HTTP y formatos de respuesta de la API WayinVideo.

## Códigos de Estado

La API utiliza códigos de estado HTTP estándar.

---

## 200 OK

La solicitud fue exitosa. El cuerpo de la respuesta es JSON con el payload en `data`.

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

---

## 400 Bad Request

Error del lado del cliente — parámetros inválidos, formato de vídeo no soportado u otros problemas. Revisa el campo `message`, corrige la solicitud y vuelve a intentarlo.

| Campo | Tipo | Descripción |
|-------|------|-------------|
| `trace_id` | string | Identificador único para diagnóstico |
| `message` | string | Descripción del error legible por humanos |

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

---

## API Units insuficientes

Si la cuenta no tiene suficientes API Units para enviar la tarea, la API responde **400 Bad Request**. No se crea la tarea y no se descuentan unidades. El cuerpo incluye `message` y `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"
}
```

Las tarifas están en [Facturación](https://wayin.ai/es/api-docs/pricing/).

---

## 500 Internal Server Error

Error del lado del servidor. Si el problema persiste, contacta al soporte con el `trace_id`.

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

---

## 403 Forbidden

Fallo de autenticación. La respuesta incluye: `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

Límite de tasa o concurrencia superado. Mismo formato que 403.

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

Consulta [Límites de Tasa](https://wayin.ai/es/api-docs/rate-limits/) para los valores de los límites.