Communitygithub.com

H3 Video:AI 短剧全流程

Fluxo completo para criar curtas-metragens de IA com diálogos, fábulas antropomórficas e histórias curtas usando ComfyUI local (MiniMax H3 + Qwen-Image + VoxCPM2): definição de tom, roteiro de falas, dublagem, modelos de personagens, primeiro quadro, geração H3, verificação de fala por frase, upscaling, legendas, loudness e capa.

O que é H3 Video:AI 短剧全流程?

Esta skill oferece um fluxo de trabalho completo e estruturado para a produção de curtas-metragens de IA com diálogos, utilizando as ferramentas locais ComfyUI, MiniMax H3, Qwen-Image e VoxCPM2. Ela foi projetada para evitar retrabalho, seguindo uma abordagem de "planejar primeiro e validar em cada etapa", onde cada fase (planejamento, dublagem, modelos de personagens, primeiro quadro, geração de vídeo, verificação de fala, pós-produção) é revisada antes de prosseguir. A skill inclui regras rigorosas, como nunca misturar narração com vídeo H3 (para evitar sincronia labial incorreta), usar a tabela de falas como fonte única da verdade e verificar quadro a quadro o movimento dos lábios de cada falante. Ela suporta múltiplas plataformas (Claude Code, Cursor, Codex) através de scripts Python que se conectam ao ComfyUI via variável de ambiente `COMFY_URL`. O fluxo cobre desde a pesquisa inicial e planejamento até a geração de vídeo, dublagem, legendagem, ajuste de loudness e criação de capas, com scripts dedicados para cada etapa e documentação detalhada de referência sobre lições aprendidas e parâmetros de nós.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/huihezuo-source/H3-Video/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

H3 Video:Fluxo Completo de Curta-Metragem com IA

Este fluxo foi desenvolvido a partir da experiência de retrabalho em várias produções reais. A ideia central é: planejar primeiro, validar cada etapa e, se algo der errado, corrigir apenas a camada afetada.

Fluxo Geral (em ordem, sem pular etapas)

EtapaO que fazerPonto de Verificação
0Pesquisa: Primeiro, estude obras similares de sucesso e as abordagens dos outros; anote as técnicas.—
1Escrever o planejamento: tom e estilo, tabela de falas, segmentação, lista de geração (modelo em templates/planejamento.md)Usuário confirma o planejamento
2Dublagem: Narração e voz em off com TTS separado; meça a duração realUsuário ouve e confirma o timbre
3Modelos de personagens: Uma foto de corpo inteiro de cada personagem, no mundo da históriaUsuário confirma o modelo
4Primeiro quadro: Um por segmento, apenas no início da açãoUsuário deve confirmar o primeiro quadro antes de gerar vídeo
5Geração: Use as configurações mais rápidas para um rascunho inicial—
6Verificação de fala por frase, verificação de olhar, verificação de emendaSe erro, refaça apenas aquele segmento
7Upscaling, legendas, loudness, capaUsuário aprova
8Revisão: Avalie cada item da lista de "abordagens a verificar" do planejamento e registre os aprendizados na base de conhecimento—

Sete Regras Rígidas

  1. O estilo deve servir ao tom da história. Antes de desenhar qualquer coisa, escreva a seção "Tom e Estilo": fontes de luz e escuridão, paleta de cores, roupas (novas/velhas/sujas), expressões, atmosfera de fundo. Os modelos também são criados neste mundo, sem fundo cinza de estúdio. Cada imagem deve responder primeiro: "Ela pertence a esta história?" antes de verificar os detalhes. O erro mais comum é uma história sombria com rostos de ídolos limpos e bonitos.
  2. Uma geração tem apenas uma fonte de som. Narração e voz em off nunca entram no H3; caso contrário, os personagens na tela sincronizarão os lábios com a narração, mesmo com o prompt "boca fechada". Para segmentos de narração, gere vídeo sem falas e sobreponha o áudio na pós-produção.
  3. Personagens presentes mas sem falas: Não forneça falas durante a geração; se um falante precisar ficar oculto, filme de costas ou ombro.
  4. A tabela de falas é a única fonte da verdade. Cada linha deve registrar: tipo (diálogo/voz em off), falante, para quem olha, texto original. Estime cerca de 3 caracteres/segundo; cada frase deve terminar dentro do seu segmento. Etapas posteriores não podem alterar a tabela de falas.
  5. Olhar: O falante olha para o ouvinte; o ouvinte olha para o falante. Especifique no prompt de cada linha quem olha para quem.
  6. Se o primeiro quadro tiver erro, refaça o primeiro quadro, não tente corrigir com prompt. Ao verificar, amplie para a resolução original e examine mãos, olhos, boca, adereços e objetos extras.
  7. Não entregue sem verificar a fala de cada frase. Para cada linha de fala, extraia uma grade densa de quadros do intervalo de tempo (scripts/speaker_grid.py) e responda apenas a uma pergunta fechada: "A boca de quem está se movendo: A / B / Ambos / Nenhum". Em seguida, compare com a tabela de falas. Amostrar apenas 4 quadros esparsos pode resultar em falhas.

Princípios de Geração e Retrabalho

  • Primeiro rascunho, depois upscaling: Use a resolução mais rápida para gerar vídeos; após a confirmação, faça o upscaling apenas das versões aprovadas.
  • Falha primeiro, identifique a causa: Determine se o problema está no prompt, no primeiro quadro, no script ou na pós-produção; depois decida qual camada corrigir. Se o mesmo erro ocorrer em vários segmentos, corrija a referência compartilhada (modelo); se for apenas um segmento, corrija apenas ele; altere um item por vez.
  • Escreva prompts de forma positiva, sem acumular "não...". Para evitar algo, corrija a entrada (primeiro quadro, modelo).
  • Registre o primeiro quadro, modelo, semente e prompt usados em cada segmento, facilitando refazer apenas um segmento.
  • Teste de 2 segundos no início: Olhe apenas os primeiros 2 segundos; o público precisa saber o que está vendo.

Referências

  • references/detalhes_licoes.md: Passo a passo de cada etapa e erros cometidos.
  • references/nos_comfyui_parametros.md: Nós e parâmetros do Qwen-Image para modelos, Qwen-Image-Edit para edição de imagem, VoxCPM2 para clonagem de voz, H3 Ref2VA, além de soluções para falhas conhecidas.
  • references/pesquisa_pipelines_abertos.md: Comparação de 9 projetos de vídeo com IA de código aberto; quais valem a pena adotar e quais não.
  • templates/planejamento.md: Modelo de documento de planejamento, incluindo tabela de falas e lista de verificação.

Scripts

Todos os scripts se conectam ao ComfyUI através da variável de ambiente COMFY_URL (padrão http://127.0.0.1:8188). Consulte scripts/README.md para uso.

ScriptFunção
t2i_masters.pyGera modelos de personagens em lote com Qwen-Image (prefixo de estilo + descrição de cada um)
edit_image.pyEdita partes específicas de uma imagem com Qwen-Image-Edit, mantendo o resto inalterado
voice_design.pyProjeta vozes de personagens com VoxCPM2 descritas em texto; gera duas amostras A/B para cada um
tts_clone.pyClona timbre de voz com VoxCPM2 usando um trecho de referência; gera narrações em lote
h3_ref2va.pyMonta e submete o workflow H3 Ref2VA (imagem de referência, áudio de referência, âncora do primeiro quadro)
wait_download.pyAguarda o término da tarefa e baixa todas as saídas
ws_progress.pyExibe o progresso da tarefa (requer o client_id usado na submissão)
asr.pyTranscrição com faster-whisper para verificar se a dublagem está idêntica ao texto
speaker_grid.pyExtrai uma grade densa de quadros por frase da tabela de falas para verificação de fala
upscale_video.pyAumenta a resolução do vídeo quadro a quadro com RealESRGAN
post_subtitle_loud.pyQueima legendas + aplica loudnorm duplo para -14 LUFS
make_cover.pyGera capas nos formatos 3:4 e 9:16

Habilidades Relacionadas