Códigos de Status

A API usa códigos de status HTTP padrão. O formato do corpo da resposta depende do código de status.

200 OK

A requisição foi bem-sucedida. O corpo da resposta é JSON contendo apenas o payload em data.

Exemplo

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

400 Bad Request

Ocorreu um erro do lado do cliente — parâmetros inválidos, formato de vídeo não suportado ou outros problemas de entrada. Revise o campo message, corrija a requisição e tente novamente.

Campo	Tipo	Descrição
`trace_id`	string	Identificador único para diagnóstico e suporte
`message`	string	Descrição do erro legível por humanos

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

500 Internal Server Error

Ocorreu um erro do lado do servidor. Se o problema persistir, entre em contato com o suporte informando o trace_id.

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

403 Forbidden

Falha na autenticação (chave de API inválida ou ausente). O corpo da resposta inclui:

Campo	Tipo	Descrição
`timestamp`	string	Hora da resposta (ISO 8601)
`status`	number	Código de status HTTP (403)
`error`	string	Tipo de erro curto (ex.: `"Forbidden"`)
`path`	string	Caminho da requisição

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

429 Too Many Requests

A requisição foi rejeitada devido a limites de taxa ou de concorrência. O corpo da resposta usa o mesmo formato que o 403: timestamp, status, error, path.

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

Consulte Limites de Taxa para os valores dos limites e como evitar o erro 429.