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.

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

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

500 Internal Server Error

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

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

403 Forbidden

Fallo de autenticación. La respuesta incluye: timestamp, status, error, path.

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

{"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 para los valores de los límites.