Que fait film-crew ?
En une phrase : la méthode de tournage gère le « comment filmer », ici ce sont les outils utilisés pendant le tournage — choisir le modèle, suivre la progression, montrer le résultat. Quatre blocs côte à côte, chacun avec son propre overview.md ; les chemins sont relatifs à ce répertoire.
Ce que gère chaque bloc
| Bloc | Gère quoi | Quand l'utiliser | À lire d'abord |
|---|---|---|---|
backends/ | Fiche de travail en entrée, vidéo et image en sortie | Pour générer une vidéo ou un ensemble d'images ; pour voir d'abord ce qui sera envoyé ; pour choisir un modèle | backends/overview.md |
viewer/ | Répertoire d'exécution → page web pour les humains | Pendant le tournage, pour voir chaque génération (page de progression) ; après le tournage, pour voir ce qui a été donné à chaque plan et ce qui en est sorti (vitrine, graphe de nœuds) | viewer/overview.md |
comfyui/ | Chaque plan importé dans ComfyUI | Quand un humain veut voir dans ComfyUI comment un plan a été réalisé, et récupérer les images clés et la vidéo pour les utiliser ensuite | comfyui/overview.md |
formats/ | Format des deux fichiers d'échange | Pour écrire ou vérifier une fiche de travail ; pour transformer un répertoire d'exécution en manifeste des plans | formats/overview.md |
Les quatre blocs communiquent uniquement via deux fichiers : la fiche de travail (ce qui doit être généré en une fois) est envoyée au backend ; le manifeste des plans (ce que chaque plan d'un film a utilisé et produit) est donné aux deux visualiseurs.
Où ils interviennent pendant le tournage d'un film
- Début du tournage : la page de progression démarre dans tmux, puis chaque génération y est listée —
python3 viewer/scripts/progress.py <répertoire de sortie> --jobs <projet>/clips --prices backends/cards/prices.json --every 60. - Génération : chaque génération écrit une fiche de travail dans
<projet>/jobs/(vidéo) ou<projet>/jobs_img/(image). D'abordpython3 backends/scripts/filmgen.py request <fiche>pour voir ce qui sera envoyé, puisrun. Le backend appelle les API officielles : 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). Le choix du modèle se fait via backends/cards/. - Fin du tournage : dans le répertoire d'exécution, écrire un fichier de métadonnées
meta.json(nom de chaque plan, temps de début et fin dans le montage final, quelle génération a été utilisée), puis lancerpython3 formats/read_run.py <configuration> --out <répertoire du manifeste>pour générer le manifeste des plans, etpython3 formats/check_manifest.pypour le valider. - Montrer aux humains : la page web se lance avec
python3 viewer/scripts/console.py <manifeste…> <répertoire de sortie>; pour ouvrir dans ComfyUI, utiliserpython3 comfyui/scripts/shots2comfy.py <manifeste…> --comfy <répertoire ComfyUI>. Le graphe de nœuds dans la page web reproduit le workflow ComfyUI ; pour l'obtenir, exécutez d'abordshots2comfy.py, puis ajoutez--workflowsàconsole.py.
Prérequis : Python 3.10 ou supérieur. backends, formats, la page de progression et shots2comfy.py utilisent uniquement la bibliothèque standard (backends mesure la durée des vidéos avec ffprobe) ; la vitrine (console.py) nécessite en plus Pillow et ffmpeg ; send nécessite ssh et tmux sur la machine distante ; les nœuds ComfyUI s'exécutent dans leur propre environnement (avec Pillow, numpy fournis par ComfyUI).
Les paramètres de chaque étape et ce qu'il faut vérifier après exécution se trouvent dans le fichier overview.md de chaque bloc.
Règles
- Les clés ne sont lues que depuis les variables d'environnement (
DASHSCOPE_API_KEY,ARK_API_KEY,MINIMAX_API_KEY,OPENAI_API_KEY), jamais écrites dans un fichier, jamais affichées. Si une clé n'est pas définie,requestfonctionne quand même. - Les visualiseurs sont en lecture seule : ils ne modifient pas le répertoire d'exécution, n'appellent pas les API de génération. Si un humain voit quelque chose à ajuster dans ComfyUI ou la page web, il le dit à l'agent, qui modifie et soumet à nouveau.
- Voir avant d'envoyer : pour chaque fiche, faites d'abord
request; pour recommencer ou changer les paramètres, enregistrez-la sous un nouveau nom. - Les pages générées doivent être vérifiées par soi-même selon la façon dont l'humain les ouvre, avant de les transmettre.