# 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

1. Gerar ou montar o esquema de vídeo
2. Validar a estrutura do esquema e as referências de assets
3. Criar um preview
4. Revisar ou refinar o esquema
5. Iniciar a tarefa de renderização final
6. Consultar o status da tarefa ou receber um webhook
7. 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](https://renderingvideo.com/docs/json-spec.md).

## 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](https://renderingvideo.com/docs/api-and-usage.md).

## Documentos relacionados

- Detalhes do esquema: [Estrutura JSON e regras de campos](https://renderingvideo.com/docs/json-spec.md)
- Fluxo de execução: [API e uso](https://renderingvideo.com/docs/api-and-usage.md)
- Payloads prontos para copiar: [Exemplos](https://renderingvideo.com/docs/examples.md)
- Guias práticos começando do zero: [Tutoriais](https://renderingvideo.com/docs/tutorials.md)