create-video-seedance-2-fal
⚠️ PRÉ-VÉRIFICATION OBLIGATOIRE (2026-06-04) : chaque prompt Seedance qui nomme un produit de marque DOIT être associé à une image de référence réelle de ce produit exact comme l'une des entrées
--image-ref. Une description textuelle seule du produit sans référence invite Seedance à inventer une géométrie qui ne correspond pas au SKU réel. Si aucune référence n'existe localement, trouvez-en une via brand-assets → existing-ads → PDP harvest → promouvoir versclients/<brand>/brand-assets/reference-photos/. Optionnellement, nettoyez une référence obstruée via un rapide passage GPT-image-2 edit au préalable. Obtenez toujours l'approbation de l'utilisateur pour la référence et le prompt final avant de lancer l'appel payant. Voirfeedback_product_reference_required.md.
Objectif
Encapsule le point de terminaison FAL bytedance/seedance-2.0/reference-to-video. Transmettez 1 à N images de référence (généralement : portrait + produit + décor optionnel) + un prompt structuré → recevez un clip de 4 à 15 secondes avec voix-off synchronisée et audio ambiant.
Seedance 2.0 génère plusieurs coupes internes au sein d'un seul appel de 15 secondes lorsque le prompt spécifie une structure de sous-scènes (par exemple : ACCROCHE LARGE / HÉROS PRODUIT / DÉPLACEMENT / RÉACTION). C'est l'avantage architectural par rapport à l'ancienne approche NB2 + i2v multi-keyframes — moins d'appels, synchronisation labiale native, pas besoin de Soul ID.
Utilisez cette compétence lorsque :
- Le clip nécessite un avatar parlant qui examine ou démontre un produit
- Un dialogue synchronisé est requis (définissez
--generate-audio) - L'identité doit être maintenue via une référence d'image, pas une vidéo (voir Règle de décision 1)
- Durée 4-15s, format vertical 9:16 (ou autres ratios)
- Conditionnement multi-image (visage + produit, ou visage + plusieurs produits pour une scène d'accroche)
Ne pas utiliser pour :
- Clips > 15s → diviser en plusieurs appels et assembler (
assembly/stitch-videos-ffmpeg) - Mouvements de caméra purement cinématographiques sans personne à l'écran →
create-video-veo3est souvent meilleur - B-roll produit uniquement sans personne →
create-product-videos-higgsfield-msou text-to-video Seedance - Clips nécessitant une référence vidéo pour la continuité à partir d'une scène IA précédente → non pris en charge (content_policy_violation)
Entrées
Obligatoires :
--prompt— bloc de prompt structuré (voir "Modèle de prompt" ci-dessous). Long, multi-blocs. Exemple d'exécution de référence :beauty-by-earth/video-01-three-product-grwm/working/fire_seedance_facewash.py.--output— destination locale du fichier MP4.--image-url(alias--image-ref) — au moins une URL d'image de référence PUBLIQUE (répétable), transmise commeimage_urls. L'ordre compte — le premier =@Image1dans l'adressage du prompt. Le proxy ne télécharge PAS les fichiers locaux : hébergez les références locales via MCPget_upload_url→get_download_urlet transmettez l'URL (identique àcreate-video-fal).
Optionnelles :
--resolution—480p|720p|1080p(par défaut). La 1080p améliore significativement la fidélité des étiquettes produits.--duration—4–15secondes (par défaut15). Transmis comme un entier (enumseedance-2.0/reference-to-video{auto,4..15}) ; une chaîne de caractères"15"génère une erreurinvalid_request(validé le 2026-07-18).--aspect-ratio—9:16(par défaut),16:9,1:1, etc.--generate-audio— booléen, vrai par défaut. Définir à faux pour un B-roll silencieux où la VO est ajoutée ultérieurement.--seed— entier pour des exécutions déterministes (FAL renvoie une seed ; transmettez-la pour reproduire).
Informations d'identification :
- Pas de clé FAL. Route via le proxy FAL GooseWorks (
media_proxy.py, inclus) et facture l'agent Ads, en utilisant~/.gooseworks/credentials.json(écrit par la CLIgooseworks). Votre tokencal_/agent n'est pas une clé FAL — l'ancien chemin direct avec clé générait une erreur 401 ; c'est pourquoi cette capacité a été reroutée via le proxy.
Règles de décision
0. Privilégiez MOINS d'appels, PLUS LONGS avec un prompt multi-scène interne plutôt que de nombreux appels courts. Chaque nouvel appel Seedance modifie légèrement le personnage, la tenue, l'éclairage et l'arrière-plan — même avec la même référence de portrait. 5 appels courts = 5 points de dérive que le spectateur perçoit comme des ruptures de continuité. Utilisez le modèle multi-scène éprouvé dans UN seul appel de 10 à 15 secondes pour obtenir des coupes franches internes à partir d'un seul rendu :
SCÈNE 1 (0-3s) — ACCROCHE LARGE [cadrage + action + dialogue]
SCÈNE 2 (3-7s) — HÉROS PRODUIT [cadrage + mouvement caméra + dialogue]
SCÈNE 3 (7-11s) — DÉPLACEMENT / PREUVE [cadrage + action + dialogue]
SCÈNE 4 (11-15s) — RÉACTION + APPEL À L'ACTION [cadrage + action + dialogue]
Le décor PEUT varier entre les sous-scènes internes d'un seul appel Seedance. L'identité du personnage est verrouillée par l'image de référence du portrait, pas par le décor. Référence validée (ref-01 Bristle UGC, 26s) montre le même créateur dans 5+ décors/pièces différents au sein d'un seul rendu multi-scène. Ne divisez pas artificiellement en plusieurs appels juste pour changer de pièce — intégrez les changements de décor DANS la structure de sous-scènes SCÈNE N (X-Ys) d'un seul appel. Répartissez les appels en fonction de L'ARC NARRATIF et de la limite de durée maximale de 15s, pas du nombre de décors. Voir prompt-example.md pour le modèle validé. Mémoire : feedback_seedance_long_calls_not_short.md.
0a. La TENUE doit être COMPLÈTEMENT spécifiée — haut + bas + cheveux + accessoires. Validé le 2026-05-23 (Bristle) : si seul le haut est spécifié ("sweat-shirt crème"), Seedance hallucine le bas (un short en jean est apparu de nulle part). Chaque prompt doit verrouiller tous les éléments :
- Haut (avec négations)
- Bas (avec négations) — "short en jean clair retroussé, mi-cuisse, PAS un jean, PAS un short de pyjama"
- Cheveux (coiffure spécifique — "queue-de-cheval basse lâche à la nuque avec mèches encadrant le visage" fonctionne mieux que "chignon" vague)
- Accessoires (par exemple "boucles d'oreilles créoles fines en or, rien d'autre")
Pour une UGC confessionnelle / en une seule session, la tenue doit être IDENTIQUE dans tous les appels de la même publicité (préférence utilisateur validée + motifs ref-01 + ad-03). Faites varier la tenue entre les appels UNIQUEMENT pour les formats GRWM / transformation / multi-jours. Mémoire : feedback_seedance_long_calls_not_short.md.
0b. TRANSMETTEZ UNE IMAGE DE RÉFÉRENCE D'ARRIÈRE-PLAN comme image_urls[2] pour des décors verrouillés. Validé le 2026-05-23 (Bristle). Une description textuelle seule du décor donne une esthétique de location générique — Seedance la remplit avec son propre arrière-plan par défaut. Une image de référence d'arrière-plan (générée via NB2 Pro avec fal-ai/nano-banana-pro, 0,15 $/1K, text-to-image avec directives "pas de bokeh, mise au point infinie, pas de personnes, pas de visages") VERROUILLE la pièce dans toutes les sous-scènes. Utilisez la MÊME image d'arrière-plan dans tous les appels de la même publicité — une image d'arrière-plan différente par appel donne l'impression que "elle a bougé". Mémoire : feedback_seedance_long_calls_not_short.md.
0c. NETTOYEZ AU PRÉALABLE LES IMAGES DE RÉFÉRENCE DE PRODUIT via NB2 edit si elles contiennent des accessoires. Validé le 2026-05-23 (Bristle hi_res-12 avait des flacons et un entonnoir à côté de la boîte ; Seedance les a fusionnés sur le devant de la boîte). Inspectez les images produit sources lors de la réception. Si des accessoires / produits secondaires / badges de notation / éléments de style de vie sont visibles, acheminez via fal-ai/nano-banana-2/edit (0,08 $) pour isoler le produit héros avant de le transmettre à Seedance. Moins cher que de relancer un rendu Seedance à 4,50 $ - 10,20 $. Mémoire : feedback_nb2_clean_product_refs.md.
0d. CONTINUITÉ ENTRE APPELS SÉQUENTIELS — utilisez la réutilisation de seed, PAS video_urls. Validé le 2026-05-23 (test A/B Bristle). Pour l'appel N>1 dans une publicité multi-appels, transmettez la seed de l'appel précédent (via --seed) avec les mêmes image_urls. Ne transmettez JAMAIS le mp4 de l'appel précédent comme video_urls pour la continuité séquentielle — cela NUIT à la continuité (le modèle essaie de "continuer" la vidéo précédente ; la tenue/le produit dérivent plus que sinon). video_urls est UNIQUEMENT pour le transfert de style à partir d'une vidéo de référence HUMAINE RÉELLE (par exemple, prendre une publicité UGC de créateur réel et la recréer avec un créateur IA). Mémoire : feedback_seedance_video_urls_vs_seed.md.
0e. LORSQUE VOUS UTILISEZ video_urls (transfert de style à partir d'une référence réelle) : définissez le délai d'attente du client sur 30+ min ET rognez la référence à ≤15s. Validé le 2026-05-23 :
- Temps de rendu : ~18-20 min (contre ~10 min pour image seule). Le délai par défaut de 10 min de
fal_client.subscribe()échouera. Utilisezfal_client.submit()+ sondage manuel. - Limite de durée cumulée des
video_urls: 15s. FAL rejette avecinput_value_error: Combined video duration must not exceed 15.0s. Rognez les vidéos de référence avec ffmpeg-t 15avant le téléchargement. - Limite de taille cumulée des fichiers : 50 Mo au total. Notre limite
fal_helpers.upload_file()est passée de 10 Mo à 50 Mo le 2026-05-23. - Détectez les erreurs de validation (
input_value_error/ "must not exceed") dans les exceptions de sondage et abandonnez après 1 à 2 nouvelles tentatives — les erreurs terminales ne remontent pas viastatus=Failed. - La référence vidéo transfère PLUS que le style/rythme — elle transfère la tenue, les accessoires, les cheveux de manière non négligeable (validé le 2026-05-23 Recreation Probiotique : les cheveux ont basculé pour correspondre à la référence ; des comprimés sont apparus malgré l'image produit nettoyée). Les surcharges côté texte sont PARTIELLEMENT efficaces ; choisissez une référence dont les visuels correspondent déjà à votre cible.
- FAL ACCEPTE bien une vidéo générée par IA comme entrée (l'ancienne hypothèse "content_policy_violation instantanée" de BBE début 2026 est obsolète). Mémoire :
feedback_seedance_video_urls_vs_seed.md.
1. Ne transmettez JAMAIS une vidéo générée par IA comme video_urls. Le validateur de politique de contenu de FAL rejette cela avec partner_validation_failed. La réduction de 60 % sur l'entrée vidéo est réelle mais ne s'applique qu'à une vidéo de référence HUMAINE RÉELLE. Pour la continuité d'un avatar IA à travers plusieurs scènes, utilisez le même portrait d'identité comme image_urls dans chaque scène. Validé sur BBE.
2. Rejet NSFW → ARRÊTEZ et remontez, ne refaites pas automatiquement. L'application corporelle + femme + eau/mousse déclenche le classificateur de manière fiable. Si FAL renvoie content_policy_violation ou status: failed avec une raison nsfw, ne relancez PAS le même prompt. Remontez à l'appelant avec 3 options : réécrire le temps d'application comme test olfactif / bout des doigts, recadrer en POV (sans visage), ou sauter la scène. Suit la politique de modération à l'échelle du projet (voir mémoire feedback_hf_moderation_surface.md).
3. duration comme un ENTIER. Transmettez 15, pas "15". seedance-2.0/reference-to-video rejette une durée sous forme de chaîne avec invalid_request (validé le 2026-07-18 ; l'ancienne note "chaîne uniquement" concernait le point de terminaison i2v v1 obsolète).
4. Un seul produit par appel (sauf accroche). Les scènes multi-produits héros au sein d'un seul appel Seedance dégradent la fidélité des étiquettes. L'exception est la scène d'accroche/intro où tous les produits apparaissent ensemble mais aucune étiquette unique n'est en héros.
5. 1080p pour une qualité héros. La texture de la peau et la netteté des étiquettes produits s'améliorent sensiblement avec la résolution. Utilisez la 720p uniquement pour les appels budget/de test.
Flux de travail
python3 scripts/generate.py \
--prompt "$(cat prompt-scene-1.txt)" \
--output /path/to/scene-1.mp4 \
--image-url "https://<hosted>/portrait.png" \
--image-url "https://<hosted>/product.png" \
--resolution 1080p \
--duration 15 \
--aspect-ratio 9:16 \
--generate-audio
Le script :
- Route via le
media_proxy.pyinclus (proxy FAL GooseWorks) — pas de clé FAL ; facture l'agent Ads via~/.gooseworks/credentials.json. - Transmet les valeurs
--image-urldirectement commeimage_urls(elles doivent déjà être des URL PUBLIQUES ; l'orchestrateur héberge les références locales via MCP). - Soumet
bytedance/seedance-2.0/reference-to-videovia le proxy et sonde jusqu'à la fin avec :{ "prompt": <prompt>, "image_urls": [<refs>], "resolution": <res>, "duration": <dur>, # int "aspect_ratio": <ar>, "generate_audio": <bool>, "seed": <optional int>, } - Télécharge le MP4 résultant vers
--output. - Écrit
<output>.meta.jsonavec le prompt, les références, l'URL vidéo, la seed, la durée, l'estimation de coût. - En cas de
content_policy_violationou d'échec NSFW : remonte l'erreur et se termine avec un code non nul (pas de nouvelle tentative silencieuse).
Sortie
<output>— clip MP4 à la durée, résolution et rapport d'aspect demandés.<output>.meta.json— métadonnées de la demande + résultat + seed pour la reproductibilité + estimation de coût.
Tarifs (2026-05)
| Résolution | Durée | Coût par appel |
|---|---|---|
| 720p std | 15s | ~4,54 $ |
| 1080p std | 15s | ~10,20 $ |
| 1080p std | 8s | ~5,44 $ |
| 1080p std | 4s | ~2,72 $ |
Le niveau rapide est ~20 % moins cher mais plafonne à 720p.
Modèle de prompt
Le prompt est le levier de qualité le plus important. Utilisez la structure éprouvée du modèle BBE :
📱 REVUE DE PRODUIT [PRODUIT] PAR INFLUENCEUR UGC (STYLE SELFIE, PAS UNE PUB)
[BLOC 0 — ouverture anti-modèle]
Ce n'est PAS une pub cinématographique, PAS une publicité de catégorie [catégorie], PAS une campagne éditoriale.
C'est un vrai Reel Instagram filmé par un créateur [démographie] d'une vingtaine d'années avec
la caméra frontale de son iPhone, parlant directement à ses abonnés sur un ton détendu et confiant...
[AFFECTATIONS DES RÉFÉRENCES IMAGES]
Utilisez @Image1 comme visage/identité de l'influenceur. Utilisez @Image2 comme le [produit] exact
qu'il examine — c'est une [DESCRIPTION VISUELLE]. Ce n'est PAS une [confusion courante].
Le produit et l'étiquette DOIVENT être clairement identifiables.
[BLOC FORMAT]
- Esthétique selfie vertical 9:16 filmé au téléphone, léger micro-tremblement tenu à la main
- TENUE (STRICTE) : [tenue]. ABSOLUMENT PAS [liste de négations].
- Décor : [décor]
- Éclairage : [éclairage]
- Peau réelle, légèrement imparfaite (peu de maquillage naturel), léger hâle doré
[BLOC IDENTITÉ]
Même jeune femme que @Image1 — [tranche d'âge, cheveux, yeux, teint]
[BLOC CADRAGE DYNAMIQUE]
La vidéo doit varier son cadrage à travers les scènes comme un vrai Reel — ne restez PAS
sur une seule focale tout le temps. Mélangez plans larges / moyens / gros plans.
[SCÈNE 1 (0-3s)] ACCROCHE LARGE — [texte du script] + [émotion + action]
[SCÈNE 2 (3-7s)] HÉROS PRODUIT avec rotation — [texte du script] + [émotion + action]
[SCÈNE 3 (7-11s)] Application ou test olfactif DÉPLACEMENT — [texte du script] + [émotion + action]
[SCÈNE 4 (11-15s)] RÉACTION + recommandation — [texte du script] + [émotion + action]
[DIRECTION AUDIO]
[Caractère vocal : ton, accent, rythme selon DELIVERY_STYLES.md]
PAS de musique dans l'audio (nous ajoutons la musique en post-production).
[RÈGLES GLOBALES]
- Tenue identique dans toute la scène
- Le produit reste identique et clairement visible dans sa main
- Les lèvres restent FERMÉES entre les battements de dialogue
- [Négations de contournement NSFW si pertinent]
[RÈGLES DE RÉALISME STRICT — Bloc F]
- Petites imperfections naturelles, léger duvet de pêche, fines ridules
- PAS plastique, PAS aérographe, PAS poupée, PAS porcelaine
- Reflets sur la peau UNIQUEMENT sur le bout du nez, les pommettes, l'arc de Cupidon
- Cheveux : mèches individuelles
...
[tronqué pour la traduction]