AsLSX99/ai-video-workflow

Fluxo Completo de Vídeo com IA (Versão Codex como Diretor)

Este fluxo resolve um problema: criar um vídeo de IA satisfatório a partir de uma ideia, com o menor custo possível e a menor taxa de 'sorte' (menos retentativas). O método é baseado em um artigo prático de Eian (x.com/EianLu/article/2118317430665613741). Este skill substitui o diretor geral (Claude) pelo Codex — você só tem o Codex, então deixe o Codex fazer tudo: escrever a história, escrever prompts, desenhar e codificar a pós-produção.

Princípio Central: Bloquear Erros Antes de Gastar Dinheiro

A hierarquia de custos determina toda a ordem do trabalho:

• Modificar algumas palavras no prompt: quase grátis
• Redesenhar uma imagem: sem custo extra
• Regenerar um vídeo: paga-se por segundo (2.5 ~ ¥1,5/s, 2.0 mini ~ ¥0,5/s, 720p)

Portanto: Erros encontrados no texto não devem ir para a imagem; erros encontrados na imagem não devem ir para o vídeo. Cada etapa tem uma verificação independente; só se avança para a próxima etapa após a aprovação.

Divisão de Trabalho

Papel	Responsabilidade
Eu (humano)	Escolher direção, confirmar estilo, aprovar gastos, assistir ao movimento, ouvir o áudio
Codex (diretor-geral + artista)	Escrever história e storyboard, escrever todos os prompts, usar sua própria ferramenta de geração de imagem para criar arte conceitual / frames de amostra / quadros-chave, verificar cada imagem quadro a quadro, escrever scripts ffmpeg/Python para pós-produção
Seedance (animador)	Transformar quadros-chave em alguns segundos de vídeo
Sessão de Revisão Independente	Abrir uma nova sessão para cada etapa, fornecer apenas o material, sem conclusões, apenas identificar erros sem modificar arquivos

A revisão independente é o segredo da baixa taxa de 'sorte': a sessão principal conversou com você por muito tempo, sabe o que você quer dizer e tende a 'preencher lacunas' ao ler o material; a nova sessão não sabe de nada, então qualquer coisa que ela não entender indica que realmente não foi explicado claramente. A sessão de revisão recebe apenas o material da etapa atual, sem nenhuma conclusão e sem outros arquivos.

Verificação de Ambiente (Primeira Coisa ao Iniciar)

Execute python scripts/env_check.py para verificar codex, ffmpeg, Python ≥3.9 e a variável de ambiente ARK_API_KEY. Se faltar algo, informe ao usuário para completar.

Crie uma nova pasta para o projeto. Todos os arquivos devem ficar dentro dela. Estrutura sugerida:

pasta_do_projeto/
├── 00-story/        # História, storyboard
├── 01-style/        # Estilo visual, arte conceitual
├── 02-frames/       # Quadros-chave de cada cena
├── 03-prompts/      # Prompts de vídeo para cada segmento
├── 04-videos/       # Clipes gerados (versões antigas sempre mantidas)
├── 05-post/         # Arquivos intermediários de pós-produção, produto final
└── review-log.md    # Conclusões da revisão de cada etapa e registro de gastos

Prompt para Iniciar o Projeto

Envie o conteúdo completo de templates/00-director.md para o Codex iniciar o projeto. Ele primeiro perguntará sobre duração, proporção de tela, orçamento total, trilha sonora e legendas, depois verificará o ambiente. Depois disso, comunique-se apenas com ele.

Fluxo de Oito Etapas

Cada etapa indica: o que fazer → qual template usar → condição para passar.

Etapa 1: Ideia → Roteiro Completo

• Conte sua ideia inicial ao Codex e discutam até que a narrativa esteja finalizada. Estrutura preferida: segmentada (as cenas não precisam se conectar, é mais estável); a estrutura contínua é a mais propensa a erros.
• 5 critérios para uma boa história: ① Lógica realista (para cada reviravolta, pergunte: por que isso aconteceu? De onde veio? É alcançável?) ② Dá para resumir em uma frase o que quer expressar ③ Começa de forma cativante ④ As reações dos personagens parecem reais (cada reviravolta em 3 partes: problema → como o protagonista resolve → qual a reação dos outros; as reações devem ter ordem) ⑤ A cena pode ser gerada por IA (evite a lista de pontos fracos: pessoas se cruzando, segurando objetos pequenos, texto, reflexos em espelhos, assimetria esquerda-direita, mudança de luz em um único take, pessoa fazendo três ações seguidas, ângulo plongée sem rosto visível, muitos coadjuvantes).
• Template: preencha templates/01-story.md e envie ao Codex.
• Aprovação: Abra uma nova sessão de revisão, forneça apenas o roteiro finalizado e use templates/02-story-review.md para revisar. Obtenha "Aprovado".

Etapa 2: Storyboard (A Mais Importante no Início; Composição e Cor São Mais Importantes que o Roteiro)

• Para cada cena, escreva: tempo dentro da cena (arredondar para cima com 0,5s extra), duração de geração em segundos, enquadramento, ângulo de câmera, movimento de câmera, quem se move para onde (esquerda/direita da tela), qual expressão impulsiona a cena, o que está em movimento, como fazer a transição para a próxima cena.
• 6 requisitos rígidos: ① Mude o ângulo em cada cena; no máximo 2 cenas com ângulo frontal direto em todo o vídeo ② Sempre haja algo em movimento na tela ③ Alterne entre plano geral, plano médio e close-up ④ Cada cena deve ter pelo menos um objeto em movimento; mova quando necessário e pare quando necessário ⑤ O movimento de câmera deve ter uma razão (seguir algo / aproximar lentamente / afastar) ⑥ Composição seguindo a regra dos terços; a cabeça ou os olhos devem estar nos 38% ou 62% da esquerda.
• Projete o esquema de cores separadamente; liste a paleta de cada cena; converta para preto e branco para verificar; se o personagem e o fundo não se distinguirem, ajuste as cores.
• Se houver um vídeo de referência, peça ao Codex para medir quadro a quadro as posições da câmera e as proporções de entrada/saída para imitar.
• Template: templates/03-storyboard.md.
• Aprovação: Um quadro geral de blocos de cores (1920×1080 com marcações de 38%/62%) para o usuário confirmar.

Etapa 3: Definir Estilo Visual, Criar Arte Conceitual

• Se tiver imagens de referência, melhor. Forneça-as diretamente. Codex escreve os prompts e gera as imagens; o usuário apenas avalia se o estilo está correto.
• Cada personagem e objeto fixo deve ter uma imagem conceitual: frente, perfil e algumas expressões. Características fixas devem ser escritas de forma absoluta (ex.: "a tatuagem está no braço esquerdo").
• Aprovação: O usuário confirma o estilo visual; só então é permitido desenhar as cenas oficiais.

Etapa 4: Criar Quadros-Chave (Primeiro e Último Frame) de Cada Cena (Passo Mais Crucial para Reduzir a Taxa de 'Sorte')

• Ordem: Primeiro, peça ao Codex para escrever "o que desenhar no primeiro frame, o que desenhar no último frame e o que acontece no meio" para cada cena; após aprovação da revisão, desenhe (para economizar créditos) → Desenhe primeiro o último frame (que geralmente tem mais conteúdo) → Modifique o último frame para criar o primeiro frame (garantindo a mesma posição de câmera e composição) → Para o mesmo local com mesma câmera, faça modificações locais → Para zoom in, recorte uma parte do primeiro frame e amplie como último frame → Verifique se a proporção é 16:9 e se os tamanhos do primeiro e último frame são consistentes.
• Após desenhar, use templates/04-frame-check.md para verificar 8 itens (ações e objetos já aparecem no primeiro frame, reações são posicionadas com antecedência, poses não são todas iguais, espaço para movimento, direção do vento consistente, verifique o tamanho do celular, amplie para ver objetos extras, sobreponha primeiro e último frame para verificar desalinhamento).
• Itens pequenos como chuva, chapéus, tatuagens DEVEM ser desenhados tanto no primeiro quanto no último frame; apenas descrevê-los por escrito fará com que desapareçam durante a gravação.
• Aprovação: Todos os 8 itens verificados e aprovados; o usuário concorda com as alterações antes de modificar.

Etapa 5: Escrever Prompts de Vídeo e Revisar Antes de Enviar

• Formato fixo em sete partes: [Estilo Visual] [Câmera] [Composição e Cores] [Personagens] [Segundo a Segundo] [Som] [Restrições]; descreva o que acontece a cada segundo. Template: templates/05-video-prompt.md.
• Antes de escrever, consulte references/pitfall-table.md com 20 pontos de erro comuns do modelo — se surgir um problema, suspeite primeiro do prompt, depois do modelo.
• Aprovação: Antes de cada envio, abra uma nova sessão de revisão e use templates/06-pre-submit-review.md para verificar cada detalhe do prompt e da imagem (já pegou erros como diferença de 13% no tamanho de um copo, aba de chapéu presente em um frame e ausente em outro, esquerda/direita trocados). Quando escrever "Aprovado", informe o custo ao usuário e só envie após sua concordância.

Etapa 6: Gerar Vídeos

• Use scripts/seedance.py para enviar (720p, modo quadro-chave), faça polling até obter o clipe.
• Dicas para economizar: Gere em 720p e amplie para 1080p na pós-produção; não faça clipes de teste, vá direto para o primeiro clipe oficial; para métodos novos, teste com um ou dois dos clipes mais difíceis primeiro; se funcionar, envie todos; orçamento apertado: use 2.0 mini (cerca de 1/3 do preço), suficiente para clipes não complexos; ouça o áudio antes de usar (2.5 frequentemente adiciona música mesmo quando o prompt diz "sem música").
• Ordem de resolução de problemas: ① Dá para cortar? (problema só nos primeiros/últimos quadros) ② Dá para corrigir com código? ③ Só então regrave, e antes modifique o prompt ou os quadros-chave; regrave apenas esta cena. Nunca delete clipes antigos; no final, escolha entre os novos e os antigos.
• Aprovação: O usuário viu o movimento e ouviu o áudio.

Etapa 7: Montagem, Transições, Correção de Cor, Ampliação

• Tudo feito com código: Codex escreve scripts ffmpeg/Python. Template: templates/07-postprocess.md (transições com motion blur cortando 8–16 subquadros com obturador de meio quadro; ajuste apenas saturação e brilho, não mexa no matiz; decodifique com BT.601, entregue internamente sem perdas com padrão BT.709; amplie para 1080p com lanczos e nitidez suave; para sincronia musical, detecte batidas apenas da faixa original).
• Após concluir, verifique 3 quadros antes e depois de cada corte.

Etapa 8: Revisão Final e Entrega

• Abra uma nova sessão de revisão, forneça apenas o clipe final, sem nenhuma conclusão; deixe-a assistir do início como se fosse um espectador assistindo pela primeira vez. Template: templates/08-final-review.md.
• Peça ao Codex para escrever um resumo e arquivar: estilo visual, prompts, erros cometidos; guarde tudo na pasta do projeto para reutilizar no próximo vídeo.

Modo de Quatro Threads (Opcional Avançado)

Se o projeto for complexo ou o orçamento grande, envie templates/09-four-threads.md para o Codex: quatro sessões cooperando (execução principal + revisão + supervisão + agente). O agente só pode aprovar envios dentro do orçamento total. Para vídeos pequenos do dia a dia, não é necessário; a sessão de revisão única já é suficiente.

Regras de Ferro (Inclua em Todas as Sub-sessões)

1. Antes de eu confirmar a história, não desenhe nenhuma imagem; antes de eu confirmar o estilo visual, não desenhe as cenas oficiais.
2. Antes de enviar para geração de vídeo, é obrigatória uma revisão independente com aprovação "Aprovado". Só envie após eu concordar com o custo.
3. Se o vídeo tiver problemas: primeiro tente cortar, depois corrigir com código, por último modifique o roteiro e regrave apenas esta cena.
4. Salve novas versões em novos arquivos; não sobrescreva nem delete arquivos antigos.
5. Para algo que você não viu em movimento nem ouviu o áudio, informe claramente "não vi / não ouvi".
6. Não recarregue créditos nem compre cotas; se a API retornar saldo insuficiente, pare e faça uma edição preliminar com os clipes existentes para eu ver.
7. Quando o Codex ficar sem créditos, espere recuperar; não desenhe muitas imagens de uma vez; ao modificar uma pequena parte, cole a parte modificada de volta na imagem original.

Índice de Arquivos

• templates/ — 10 templates de prompt, numerados de 00 a 09 conforme o fluxo; preencha os [colchetes] e envie.
• references/pitfall-table.md — Tabela com 20 pontos de erro comuns do modelo; consulte item por item ao escrever prompts.
• references/roles.md — Tabela de divisão de trabalho e descrição dos papéis no modo de quatro threads.
• scripts/env_check.py — Verificação de ambiente.
• scripts/seedance.py — Envio, polling e download do Seedance.