Fluxo de API de render de vídeo: do schema ao MP4

Renderização é assíncrona e não deve ser uma única requisição HTTP longa. RenderingVideo separa criação da tarefa e início do render, permitindo validar antes de consumir créditos.

Princípios principais

• Consultar capabilities antes de usar recursos novos.
• Manter a API key apenas no backend confiável.
• Persistir task ID, status, revisão e URL final.
• Combinar webhook com polling de contingência.

Fluxo recomendado

1. Validar schema e assets públicos.
2. Criar com POST /api/v1/video.
3. Iniciar por POST /api/v1/video/:taskId/render.
4. Processar o resultado e aplicar sua política de retenção.

Dica de produção

Idempotência evita tarefas duplicadas e gasto desnecessário. Um job local deve corresponder a uma única tarefa remota.

Saiba mais