O que film-crew faz?
Uma frase: as regras de filmagem dizem "como filmar", aqui estão as ferramentas para usar durante a produção — ajustar modelos, acompanhar o progresso, exibir o resultado final. Quatro módulos lado a lado, cada um com seu próprio overview.md; caminhos relativos a este diretório.
O que cada módulo faz
| Módulo | O que faz | Quando usar | Leia primeiro |
|---|---|---|---|
backends/ | Ordem de serviço entra, vídeo e imagem saem | Para gerar um vídeo ou um conjunto de imagens; quer ver a requisição exata antes de enviar; precisa escolher um modelo | backends/overview.md |
viewer/ | Diretório de execução → página web para pessoas verem | Durante a produção, para ver cada geração ao vivo (página de progresso); após a produção, para ver o que cada cena recebeu e o que saiu (galeria, grafo de nós) | viewer/overview.md |
comfyui/ | Cada cena aberta no ComfyUI | Quando uma pessoa quer ver no ComfyUI como uma cena foi feita, pegando os quadros-chave e o vídeo para continuar usando | comfyui/overview.md |
formats/ | Formatos dos dois arquivos de troca | Para escrever ou verificar uma ordem de serviço; ler um diretório de execução e gerar um manifesto de cenas | formats/overview.md |
Os quatro módulos se comunicam apenas por dois arquivos: a ordem de serviço (o que será gerado em cada execução) vai para o backend; o manifesto de cenas (o que cada cena de um filme usou e produziu) vai para os dois visualizadores.
Onde eles aparecem durante a produção de um filme
- Iniciar a produção: A página de progresso é iniciada no tmux e, a cada nova geração, ela é listada —
python3 viewer/scripts/progress.py <diretório_de_saída> --jobs <projeto>/clips --prices backends/cards/prices.json --every 60. - Gerar: Cada geração escreve uma ordem de serviço em
<projeto>/jobs/(vídeo) ou<projeto>/jobs_img/(imagem). Primeiro executepython3 backends/scripts/filmgen.py request <ordem>para ver o que será enviado, depois executerun. O backend chama as APIs oficiais de cada fornecedor: Alibaba Cloud Bailian (Wan 3.0, HappyHorse 1.1), Volcano Ark (Seedance 2.5 / 2.0), MiniMax (H3-Max), OpenAI Images (gpt-image 2.6). Qual modelo escolher, veja em backends/cards/. - Finalizar a produção: No diretório de execução, escreva um manifesto de cenas
meta.json(cada cena: nome, intervalo no vídeo final, qual geração foi usada), depois executepython3 formats/read_run.py <configuração> --out <diretório_de_manifesto>para obter o manifesto de cenas, epython3 formats/check_manifest.pypara verificar. - Exibir para pessoas: A página web é
python3 viewer/scripts/console.py <manifesto…> <diretório_de_saída>; para abrir no ComfyUI, executepython3 comfyui/scripts/shots2comfy.py <manifesto…> --comfy <diretório_do_ComfyUI>. O grafo de nós na página web segue o fluxo de trabalho do ComfyUI; para isso, primeiro executeshots2comfy.pye depois adicione--workflowsaoconsole.py.
Pré-requisitos: Python 3.10 ou superior. backends, formats, a página de progresso e shots2comfy.py usam apenas a biblioteca padrão (backends usa ffprobe para medir a duração dos vídeos); a galeria (console.py) requer Pillow e ffmpeg; send requer ssh e a máquina de destino deve ter tmux; os pacotes de nós do ComfyUI rodam no próprio ambiente do ComfyUI (usando o Pillow e numpy dele).
Os parâmetros de cada etapa e o que verificar após a execução estão no overview.md de cada módulo.
Regras
- Chaves são lidas apenas de variáveis de ambiente (
DASHSCOPE_API_KEY,ARK_API_KEY,MINIMAX_API_KEY,OPENAI_API_KEY), nunca escritas em nenhum arquivo, nunca impressas.requestfunciona mesmo sem chave definida. - Visualizadores são somente leitura: não modificam o diretório de execução, não chamam interfaces de geração. Se uma pessoa vê algo que precisa ser ajustado no ComfyUI ou na página web, ela informa o agente, que altera e envia novamente.
- Veja antes de enviar: para cada ordem, execute
requestprimeiro; para refazer ou alterar parâmetros, salve como uma nova ordem com nome diferente. - As páginas geradas devem ser visualizadas por si mesmo conforme a abertura da pessoa, antes de entregar a ela.