USINA-YAML é uma especificação proposta de formato em YAML voltada à descrição de roteiros de produção audiovisual, com ênfase em vídeos curtos, incluindo metadados, restrições técnicas, referência explícita a ativos (assets), fontes (sources) e uma linha do tempo determinística por cenas.
Visão geral A proposta define o USINA-YAML como uma single source of truth (“fonte única da verdade”) para um episódio de vídeo: intenção criativa, restrições técnicas, metadados de direitos/citações e uma linha do tempo precisa por cenas, de modo a permitir integração com editores, renderizadores e fluxos assistidos por IA.
O formato busca ocupar um meio-termo entre roteiros puramente “humanos” (por exemplo, documentos de texto) e arquivos de projeto específicos de ferramentas de edição não linear (NLE), priorizando legibilidade, versionamento e possibilidade de validação automática.
Estrutura do documento Um arquivo USINA-YAML é um documento YAML que declara um identificador de esquema (schema id) e organiza informações em chaves como metadados, parâmetros de formato (ex.: proporção, resolução, FPS), diretrizes de estilo (tom, ritmo), política de áudio, variáveis/prompting, fontes e lista de ativos referenciáveis, além de uma linha do tempo (timeline) composta por cenas com intervalos de tempo.
O repositório de referência recomenda uma organização com especificação normativa (SPEC), um validador de estrutura (JSON Schema) e exemplos completos em diretórios dedicados.
Validação e regras de lint A proposta descreve duas camadas de checagem:
Validação de esquema (estrutura e tipos) por meio de um arquivo de JSON Schema. Regras de lint (consistência matemática e de referências), incluindo ordenação temporal, ausência de sobreposição de cenas, início em 0 e referências válidas a IDs declarados no documento.
Áudio e rastreabilidade Nos exemplos do repositório, o documento pode declarar um “audio bed” (música de fundo padrão) e ativos de efeitos sonoros, incluindo caminhos para arquivos de áudio, duração, checksum e créditos, além de permitir trilhas de áudio por cena (scene-level audio_tracks).
Exemplo (simplificado) A seguir, um exemplo mínimo (didático) de como uma descrição pode referenciar ativos e definir uma cena temporizada:usina_schema: "usina.script/v1.0" meta: title: "Example episode" language: "en" duration_s: 10
audio: bed: asset_id: bg_music_01 gain_db: -18
assets: - id: bg_music_01 type: "audio" uri: "assets/audio/bg_music_01.wav" license: "royalty_free" credit: "Example credit"
timeline: - id: scene_001 start_s: 0 end_s: 10 vo: "Short voice-over text..."
Relação com YAML O USINA-YAML utiliza YAML (uma linguagem de serialização de dados legível por humanos) como base sintática. O YAML 1.2 passou por revisões visando compatibilidade com JSON como subconjunto oficial.
Ver também
YAML JSON Schema Edição de vídeo Pós-produção
Referências
Ligações externas