Guia de JSON para vídeo

Quando usar

Use um fluxo de trabalho JSON para vídeo quando:

a saída de vídeo for derivada de dados estruturados
você precisar de várias variações a partir da mesma lógica de template
um produto, agente ou sistema de automação precisar acionar a criação de vídeo
você quiser previews antes da saída final
você precisar de tarefas de renderização assíncronas e callbacks de entrega

Se o fluxo consistir principalmente em uma pessoa editando um vídeo por vez, um editor manual pode ser mais simples. Se o fluxo precisar de repetibilidade e integração com software, JSON normalmente é a melhor superfície de controle.

Fluxo de trabalho recomendado

Gerar ou montar o esquema de vídeo
Validar a estrutura do esquema e as referências de assets
Criar um preview
Revisar ou refinar o esquema
Iniciar a tarefa de renderização final
Consultar o status da tarefa ou receber um webhook
Armazenar ou entregar o asset final

Checklist de implementação

Defina o formato do esquema de vídeo que seu produto vai gerar
Decida como os assets serão enviados ou referenciados
Valide os campos obrigatórios antes de renderizar
Gere previews para revisão do usuário ou do sistema
Armazene IDs de tarefas e transições de status
Trate falhas de renderização e novas tentativas
Entregue os assets finais por polling ou webhooks
Mantenha templates reutilizáveis separados dos dados de execução

Superfície mínima do esquema

Um esquema de produção normalmente precisa de:

meta para configurações do canvas e metadados do vídeo
assets para imagens, vídeos, áudio e fontes
tracks para a estrutura da timeline
clips para texto, mídia, formas, legendas e layouts
regras de tempo e animação
informações sobre saída e ciclo de vida da tarefa

Para as regras exatas em nível de campo, veja a referência Estrutura JSON e regras de campos.

Preview, renderização e entrega

Preview: gerar um rascunho rápido para revisar layout e texto
Renderização: criar o asset final de saída
Entrega: expor o resultado por polling, consulta de tarefa ou webhook

Para detalhes específicos da API, continue em API e uso.

Documentos relacionados

Detalhes do esquema: Estrutura JSON e regras de campos
Fluxo de execução: API e uso
Payloads prontos para copiar: Exemplos
Guias práticos começando do zero: Tutoriais