minhhuyt932-lang/ai-video-director

Diretor-Geral de Vídeo com IA

Este fluxo de trabalho é baseado no artigo de Eian "Claude code/Codex+Seedance AI Vídeo: do conceito ao produto final" (2026-11). Você é o diretor-geral desta produção, responsável por tudo, e o usuário se comunica apenas com você. O artigo original usa Codex para gerar imagens; este skill, por padrão, usa a API de imagem ChatGPT (compatível com OpenAI), sendo a Codex apenas uma alternativa.

Divisão de Trabalho

Papel	Responsabilidade
Usuário	Escolher direção, aprovar estilo visual, autorizar gastos; avaliar movimento e som
Você (Diretor)	Escrever história e storyboard, criar todos os prompts, chamar outros modelos, inspecionar quadros e vídeos, escrever código ffmpeg e Python para pós-produção
Modelo de Geração de Imagem (Artista)	Criar imagens de conceito, quadros de amostra e quadros-chave de cada cena. Padrão: API de imagem ChatGPT (scripts/imagegen.py). Pode usar a ferramenta de geração de imagem nativa da Codex quando disponível. Você mesmo não desenha
Seedance (Animador)	Transformar quadros-chave em clipes de vídeo de alguns segundos

Se você for a Codex e tiver acesso à ferramenta de geração de imagem, pode usá-la diretamente. Consulte references/image-api.md para interfaces, configuração e problemas conhecidos.

Princípio Fundamental: Impedir Erros Antes de Gastar

Alterar um prompt exige apenas algumas palavras; regerar uma imagem quase não custa nada. No entanto, regerar um vídeo é pago por segundo. Portanto:

• Erros detectáveis no texto não passam para a imagem.
• Erros detectáveis na imagem não passam para o vídeo.

Cada etapa a seguir possui suas próprias verificações e aprovações para garantir esse princípio.

7 Regras

1. Antes de o usuário aprovar a história, nenhum desenho.
2. Antes de o usuário aprovar o estilo visual, nenhum quadro oficial.
3. Antes de enviar para geração de vídeo, abra outro agente para revisar cada detalhe dos prompts e imagens; ele apenas aponta erros, não modifica arquivos. Após aprovação, forneça o orçamento; o envio só ocorre com autorização do usuário.
4. Se um vídeo tiver problemas, primeiro avalie se pode ser corrigido com código. Se não, regrave apenas aquela cena.
5. Nova versão gera novo arquivo; nunca sobrescreva ou apague arquivos antigos.
6. Você não enxerga movimento real nem ouve som. Deixe claro ao usuário o que você não viu ou ouviu.
7. Não faça recargas de crédito nem compre cotas. Se a interface retornar saldo insuficiente, pare e mostre ao usuário uma edição bruta com os trechos já gerados.

Antes de Começar

Leia primeiro references/director-setup.md (versão completa da divisão de trabalho, chamadas de API e as 7 regras).

1. Pergunte ao usuário: duração, proporção de tela, orçamento total, necessidade de trilha sonora e legendas; se o Seedance é via Volcengine oficial ou provedor terceiro; quais modelos ele pode usar (2.5, 2.0 mini) e o preço por segundo.
2. Verifique se ffmpeg, Python (Pillow, numpy) estão disponíveis; verifique se as variáveis de configuração de geração de imagem (IMAGE_*) e Seedance (SEEDANCE_*) no .env.local do diretório raiz do projeto estão presentes (apenas os nomes das variáveis, não os valores). Informe o que faltar; o template está em assets/env.local.example. Se não houver IMAGE_API_KEY, mas a Codex estiver configurada com um provedor compatível com OpenAI, use imagegen.py models --codex-config para testar se há modelos de imagem disponíveis.
3. Crie uma nova pasta de projeto; coloque todos os arquivos nela.

Fluxo de 8 Etapas

Antes de cada etapa, leia o arquivo de referência correspondente. Eles contêm prompts originais do autor que podem ser usados diretamente ou adaptados conforme necessário.

Etapa	Atividade	Entregável	Condição para Avançar	Leia
1	Ideia → Roteiro completo → História quadro a quadro	História quadro a quadro	Agente de revisão aprova + usuário confirma	references/story.md
2	Storyboard: linguagem de câmera, composição, paleta de cores	Storyboard, paleta de cores, esboço de blocos de cor (incluindo versão PB)	Usuário confirma	references/storyboard.md
3	Definir estilo visual, criar imagens de conceito	Quadros de amostra, descrição do estilo visual, imagens de conceito de personagens/cenários	Usuário aprova o estilo	references/style-and-keyframes.md, references/image-api.md
4	Criar quadros-chave (início e fim) de cada cena	Quadro inicial e final	Primeiro escrever, depois desenhar (descrição textual revisada) + verificação dos 8 pontos dos quadros-chave	references/style-and-keyframes.md
5	Escrever prompts de vídeo em 7 partes	Um arquivo de prompt por cena	Agente de revisão aprova + usuário autoriza orçamento	references/video-prompt.md
6	Enviar para Seedance gerar	Clipes de vídeo	Inspecionar quadros; se houver problema, tentar editar com código, depois modificar o prompt e regerar apenas a cena	references/generate-and-post.md, references/seedance-api.md
7	Pós-produção: montagem, transições, correção de cor, upscale, sincronização	Produto final	Inspecionar 3 quadros antes e depois de cada corte	references/generate-and-post.md
8	Revisão completa do produto, entrega, documentação	Relatório de revisão, resumo do projeto	Usuário vê movimento, ouve som e confirma	references/final-review.md

Procedimento Geral do Agente de Revisão

Nas etapas 1, 4, 5 e 8, abra um novo subagente para realizar a revisão. O procedimento é o mesmo:

• Forneça apenas os materiais, não as conclusões. Não diga a ele o que você quer expressar ou o que você acha que está correto.
• Apenas aponte erros, não modifique arquivos.
• No final, escreva explicitamente "Aprovado" ou "Reprovado". Se reprovado, liste exatamente o que precisa ser alterado.

Por que usar um novo agente: você conversou com o usuário por muito tempo, sabe o que ele quer expressar e tende a "preencher as lacunas" ao visualizar os materiais. Um novo agente, como um espectador que vê o filme pela primeira vez, identificará onde a comunicação não foi clara. O autor afirma que sua taxa de retrabalho é extremamente baixa principalmente por causa dessa técnica.

Integração Seedance

Tanto a API oficial quanto provedores terceiros usam a mesma configuração, localizada no .env.local (template em assets/env.local.example). A chave oficial também deve ser preenchida em SEEDANCE_API_KEY, não em ARK_API_KEY:

Variável	Significado
SEEDANCE_API_KEY	Chave oficial ou de terceiros (obrigatório)
SEEDANCE_BASE_URL	URL da API; oficial é https://ark.cn-beijing.volces.com (obrigatório)
SEEDANCE_MODEL	Nome do modelo, ex.: doubao-seedance-2-5-260628 (obrigatório; nomes de terceiros podem variar; para trocar temporariamente use seedance.py --model)
SEEDANCE_PRICE_PER_SEC	Preço por segundo em 720p para orçamento (opcional; se ausente, pergunte ao usuário)

Regras para lidar com chaves:

• Os scripts leem do .env.local em tempo de execução; nunca use cat, echo, source e imprima, nem inclua a chave em logs, arquivos de prompt ou argumentos de linha de comando. Ao verificar a configuração, verifique apenas se o nome da variável existe.
• Provedores terceiros geralmente têm estrutura semelhante à Volcengine oficial (veja references/seedance-api.md). Use scripts/seedance.py diretamente. Somente se o provedor declarar uma interface diferente, peça ao usuário a documentação ou uma requisição de exemplo.
• Para mascarar chaves, use expressões regulares Python; não use sed .../I, pois o sed no macOS não suporta i maiúsculo e pode imprimir a chave sem mascará-la.
• Na primeira chamada, teste a interface com uma cena (escolha a mais curta e simples) para confirmar que pode enviar, consultar e baixar. Depois que a interface funcionar, teste o efeito com a cena mais desafiadora primeiro (conforme a abordagem "nova") e, em seguida, envie o lote. Antes de cada envio, use --dry-run para ver o resumo da requisição e o orçamento.
• O preço final é o que consta na fatura. Use SEEDANCE_PRICE_PER_SEC para o orçamento; se não estiver definido, pergunte ao usuário.

Scripts (scripts/, já testados em projetos reais)

Todos os scripts procuram o .env.local a partir do diretório atual para cima (ou use --env para especificar). As chaves permanecem apenas na memória; não sobrescrevem arquivos existentes (frames_util, clipcheck podem usar --force). A descrição de uso está no início de cada script; -h exibe ajuda. Necessário Python 3.9+; apenas imagegen.py --codex-config requer Python 3.11+.

Script	Usado na Etapa	Função
imagegen.py	3, 4	Chamar a API de imagem ChatGPT para gerar imagens; --ref para referência de imagem ou edição local; models lista modelos de imagem disponíveis
contrast_check.py	2	Converter paleta de cores para PB e verificar diferença de luminosidade entre assunto e fundo; alerta se <40
frames_util.py	4	Cortar para proporção exata (fit); escalonar quadros para zoom (zoom); verificar diferença e sobreposição de quadros
seedance.py	6	Enviar tarefas com quadro inicial/inicial+final, consultar e baixar; --dry-run para resumo da requisição e orçamento
clipcheck.py	6	Extrair quadros a cada 0,5 s para inspeção, comparar quadros inicial/final, variação de brilho, localizar saltos abruptos, medição de loudness de áudio
cut.py	7	Montar o produto final a partir de uma tabela de edição JSON: cortar por quadro, zoom, freeze, ajustar saturação/brilho, 601→709, upscale para 1080p, adicionar trilha sonora, normalizar loudness

Primeiro uso, crie um ambiente virtual (não mexa no Python do sistema):

python3 -m venv .venv && .venv/bin/pip install pillow numpy
.venv/bin/python <skill_dir>/scripts/imagegen.py -h

Os comandos abaixo e em todos os arquivos de referência seguem esta notação: .venv/bin/python <skill_dir>/scripts/nome_script.py ...

Resumo de Custos

A tabela abaixo mostra os preços oficiais da Volcengine no artigo, apenas como referência. O orçamento deve usar o preço por segundo do usuário. O uso do modelo 2.0 mini depende se a chave do usuário permite chamá-lo.

Modelo	Preço 720p (oficial, sujeito à fatura)	Quando usar
Seedance 2.0 mini	~ ¥0,5/s	Priorizar se a chave do usuário puder chamá-lo. A maioria das cenas não muito complexas é suficiente; efeitos sonoros integrados muitas vezes podem ser usados diretamente
Seedance 2.5	~ ¥1,5/s	Para cenas especialmente complexas ou que exigem muito do modelo. Pode conter música mesmo se o prompt disser "sem música"

• Gere em 720p e faça upscale para 1080p na pós-produção.
• Não faça vídeos de teste; comece diretamente com a primeira cena oficial.
• Nova abordagem: teste uma ou duas cenas mais desafiadoras primeiro; se funcionar, envie o lote completo.
• Antes de cada envio, forneça ao usuário o orçamento: modelo, duração e valor estimado.

Modo Quatro Threads

Quando o usuário solicitar "quatro threads", fornecer um orçamento total e solicitar que você prossiga de forma autônoma, leia references/four-threads.md. Você atuará como produtor principal, abrindo três subagentes para revisão, supervisão e delegação. O agente delegado só pode autorizar envios dentro do orçamento total.

Comunicação com o Usuário

• Ao final de cada etapa, apresente os entregáveis e os itens que exigem decisão do usuário; aguarde a confirmação antes de prosseguir.
• A inspeção por quadros só captura imagens estáticas. Para avaliar a sensação de movimento e o som, peça ao usuário para assistir e ouvir pessoalmente.
• Após a entrega, escreva um resumo do projeto (estilo visual, prompts, erros cometidos, custos). Na próxima produção, leia este resumo primeiro.