Documentação

Aprende a usar a API de Video Analysis em produção — do primeiro curl ao webhook.

O que é, como funciona, X-Ray Report, créditos e casos de uso.

Tua primeira análise em 5 minutos: signup → key → curl.

audio, scenes, ocr, faces, nsfw, transcript, bpm — o que cada uma faz.

API keys, rotação, audit log e boas práticas de armazenamento.

Endpoints, payloads, códigos de erro e rate limits.

Estrutura desta documentação

Seguimos o framework Diátaxis:

Tutoriais (Quickstart) — aprende fazendo, do zero ao primeiro sucesso.
Conceitos — entende por que as coisas funcionam assim (dimensões, segurança, billing).
Referência (API) — consulta rápida para look-up durante o desenvolvimento.

Pay-per-use — cobramos por segundo de vídeo processado por dimensão habilitada. Sem mensalidade obrigatória.
Budget cap por produto — definis um limite mensal em BRL. Quando atinge, a API rejeita com HTTP 402 até virar mês ou tu aumentar.
Rate limit explícito — req/min configurável por produto. Excedeu → HTTP 429 com header Retry-After.
Webhooks assinados — toda notificação leva HMAC-SHA256. Replay protection com X-Webhook-Timestamp 5min.
Tenant isolation — cada produto tem uma API key única + tenant id no backend. Dados nunca cruzam.