O que revisão-render-ugc faz?
O portão de QC que toda receita de vídeo UGC DEVE limpar antes de publicar. Não é uma inspeção visual
/watch— é um diff determinístico transcrição-vs-script que sai com código não zero em caso de defeito para que a receita possa pararset_final_render.
Por que isso existe
O Seedance gera o áudio nativamente. Às vezes ele pronuncia uma palavra incorretamente — a
linha aprovada human-vetted volta falada como human witted; exemplos documentados:
Hume→Hune, Alitu→al-too. O defeito vive no áudio do render, então uma inspeção
visual /watch ("diálogo corresponde ao script") deixa passar, e uma passagem de legenda
subsequente grava a palavra errada literalmente. Nada estava comparando o áudio realmente
falado contra o script que o usuário aprovou.
Este portão faz exatamente isso, deterministicamente, e se recusa a publicar em caso de erro.
Quando executar
- OBRIGATÓRIO em todas as receitas
remix-ugc-*-from-sampleecreate-ugc-*-video-from-refs, na fase de QC, após o render principal existir e antes deset_final_render. - Re-executar após cada correção / nova tentativa até que PASSE.
Contrato
Antes de renderizar, persista as linhas faladas exatas aprovadas (a fala literal,
sem notas de batida) em working/approved-script.txt. Então, após o render:
python3 <pack>/review-ugc-render/scripts/review_render.py \
--video working/final.mp4 \
--script-file working/approved-script.txt \
--json working/review-verdict.json
- exit 0 → APROVADO — prossiga para publicar (
set_final_render). - exit 2 → REPROVADO — NÃO publique. Leia o relatório, corrija, re-execute.
- exit 3 → ERRO — a verificação não pôde ser executada (veja abaixo); corrija o ambiente, não publique às cegas.
Backend de transcrição (em ordem de prioridade): OPENAI_API_KEY (respeita
OPENAI_BASE_URL, então roteia através do proxy Whisper do gooseworks quando configurado) →
CLI local whisper. ffmpeg deve estar no PATH.
O que REPROVADO significa e como corrigir
| Linha do relatório | Causa raiz | Correção |
|---|---|---|
[alto] disse [witted] onde o script tem [vetted] | Seedance pronunciou a palavra incorretamente no áudio gerado | Gere uma nova semente. Se for uma marca/token cunhado, soletre foneticamente na LINHA FALADA (ex.: Ali-too, nunca um parêntese (pronunciado …) — o Seedance lê parênteses em voz alta). Veja Modos de Falha de create-video-seedance-2-fal. |
[médio] omitiu [...] / baixa similaridade | Seedance omitiu uma frase aprovada | Gere novamente; se for apenas uma palavra final, uma correção cirúrgica com stitch_replacement.py pode recuperá-la. |
⚠ áudio está efetivamente silencioso | Render errado / trilha de áudio perdida na pós-produção | Re-renderize / verifique a mixagem; nunca publique uma tomada silenciosa. |
ERRO: nenhum backend de transcrição | Sem OPENAI_API_KEY e sem whisper local | Defina a chave (proxy OPENAI_BASE_URL) ou instale whisper, depois re-execute. |
--expect-music é apenas consultivo (avisa se uma base musical estiver ausente); por si só
não reprova o portão.
Entradas
--video CAMINHO(obrigatório) — o mp4 mestre renderizado.--script-file CAMINHOou--script "texto"— o script falado aprovado. Omita ambos apenas para um clipe genuinamente sem script (a verificação de desvio é então ignorada e o portão é consultivo).--min-ratio FLOAT(padrão0.90) — similaridade de tokens transcrição↔script para aprovação.--json CAMINHO— escreve o veredito da máquina para o painel de revisão do aplicativo.
Testes
python3 tests/test_review_render.py # lógica de veredito pura; sem áudio/rede
Cobre a pronúncia incorreta canônica vetted→witted, pronúncia incorreta de nome de marca,
caudas omitidas, preenchimento benigno e o caminho consultivo sem script.
Relação com o motor de revisão content-goose
Esta é a fatia enviada, de arquivo único e portão, do mais completo
coworkers/video/molecules/review/review-loop (rubrica de 18 eixos). Aqui aplicamos
o único eixo que captura defeitos de áudio-vs-script no momento da publicação
(review-transcript-integrity / brand_text_accuracy). Revisão multi-eixo mais profunda
permanece no laboratório do content-goose.