create-video-seedance-2-fal
⚠️ ERFORDERLICHER PREFLIGHT (2026-06-04): Jeder Seedance-Prompt, der ein markenrechtlich geschütztes Produkt nennt, MUSS mit einem echten Referenzbild genau dieses Produkts gepaart werden – als einer der
--image-ref-Eingaben. Eine reine Textbeschreibung des Produkts ohne Referenz führt dazu, dass Seedance eine Geometrie erfindet, die nicht der echten SKU entspricht. Wenn lokal keine Referenz vorhanden ist, suchen Sie eine über Marken-Assets → Bestehende-Anzeigen → PDP-Ernte → Hochstufen zuclients/<brand>/brand-assets/reference-photos/. Optional können Sie eine verdeckte Referenz zuerst mit einem schnellen GPT-Image-2-Bearbeitungsschritt bereinigen. Holen Sie IMMER die Benutzerüberprüfung der Referenz + des endgültigen Prompts ein, bevor Sie den kostenpflichtigen Aufruf tätigen. Siehefeedback_product_reference_required.md.
Zweck
Kapselt den FAL-Endpunkt bytedance/seedance-2.0/reference-to-video. Übergibt 1-N Bildreferenzen (typischerweise: Porträt + Produkt + optionale Umgebung) + einen strukturierten Prompt → erhält einen 4-15s Clip mit nativer Lippen-synchroner Sprachausgabe und Umgebungsaudio.
Seedance 2.0 rendert mehrere interne Schnitte innerhalb eines einzigen 15s-Aufrufs, wenn der Prompt eine Sub-Szenen-Struktur vorgibt (z. B. WEITE KAMERA-HOOK / PRODUKT HERO / SEITENSCHRITT / REAKTION). Dies ist der architektonische Vorteil gegenüber dem älteren NB2 + i2v-Multi-Keyframe-Ansatz – weniger Aufrufe, native Lippensynchronisation, keine Soul ID erforderlich.
Verwenden Sie dieses Atom, wenn:
- Der Clip einen sprechenden Kopf-Avatar benötigt, der ein Produkt vorstellt oder demonstriert
- Native, lippen-synchrone Dialoge erforderlich sind (setzen Sie
--generate-audio) - Die Identität über eine Bildreferenz, nicht über eine Videoreferenz, gehalten werden muss (siehe Entscheidungsregel 1)
- Länge 4-15s, vertikal 9:16 (oder andere Seitenverhältnisse)
- Multi-Image-Konditionierung (Gesicht + Produkt, oder Gesicht + mehrere Produkte für eine Hook-Szene)
Verwenden Sie es NICHT für:
-
15s Clips → auf mehrere Aufrufe aufteilen und zusammensetzen (
assembly/stitch-videos-ffmpeg) - Reine filmische Kamerabewegungen ohne eine Person im Bild →
create-video-veo3ist oft besser - Produkt-only B-Roll ohne Person →
create-product-videos-higgsfield-msoder Text-zu-Video Seedance - Clips, die eine Videoreferenz für die Kontinuität einer früheren KI-generierten Szene benötigen → nicht unterstützt (content_policy_violation)
Eingaben
Erforderlich:
--prompt– strukturierter Prompt-Block (siehe „Prompt-Vorlage" unten). Lang, mehrblöckig. Beispiel für eine Referenzausführung:beauty-by-earth/video-01-three-product-grwm/working/fire_seedance_facewash.py.--output– lokales MP4-Ziel.--image-url(Alias--image-ref) – mindestens eine ÖFFENTLICHE Referenzbild-URL (wiederholbar), übergeben alsimage_urls. Die Reihenfolge ist wichtig – die erste wird als@Image1im Prompt adressiert. Der Proxy lädt KEINE lokalen Dateien hoch: Hosten Sie lokale Referenzen über MCPget_upload_url→get_download_urlund übergeben Sie die URL (identisch mitcreate-video-fal).
Optional:
--resolution–480p|720p|1080p(Standard). 1080p ist für die Wiedergabetreue von Produktetiketten deutlich besser.--duration–4–15Sekunden (Standard15). Wird als int übergeben (seedance-2.0/reference-to-videoAufzählung {auto,4..15}); ein String führt zuinvalid_request(validiert am 2026-07-18).--aspect-ratio–9:16(Standard),16:9,1:1, usw.--generate-audio– bool, Standard true. Setzen Sie false für stumme B-Roll, bei der VO später hinzugefügt wird.--seed– Ganzzahl für deterministische Wiederholungsläufe (FAL gibt einen Seed zurück; übergeben Sie ihn, um zu reproduzieren).
Anmeldeinformationen:
- Kein FAL-Schlüssel. Wird über den GooseWorks-FAL-Proxy (
media_proxy.py, mitgeliefert) abgewickelt und belastet den Ads-Agent, unter Verwendung von~/.gooseworks/credentials.json(geschrieben von dergooseworksCLI). Ihrcal_/Agent-Token ist kein FAL-Schlüssel – der alte direkte Schlüsselpfad führte zu 401; deshalb wurde diese Fähigkeit über den Proxy umgeleitet.
Entscheidungsregeln
0. Bevorzugen Sie WENIGERE, LÄNGERE Aufrufe mit interner Multi-Szenen-Prompting gegenüber vielen kurzen Aufrufen. Jeder neue Seedance-Aufruf verändert Charakter, Kleidung, Beleuchtung und Hintergrund leicht – selbst mit derselben Porträt-Referenz. 5 kurze Aufrufe = 5 Drift-Punkte, die der Betrachter als Kontinuitätsbrüche wahrnimmt. Verwenden Sie die bewährte Multi-Szenen-Vorlage INNERHALB EINES 10-15s Aufrufs, um interne, harte Schnitte aus einem einzigen Render zu erhalten:
SZENE 1 (0-3s) — WEITE AUFNAHME / HOOK [Bildausschnitt + Aktion + Dialog]
SZENE 2 (3-7s) — PRODUKT HERO [Bildausschnitt + Kamerabewegung + Dialog]
SZENE 3 (7-11s) — SEITENSCHRITT / BEWEIS [Bildausschnitt + Aktion + Dialog]
SZENE 4 (11-15s) — REAKTION + CTA [Bildausschnitt + Aktion + Dialog]
Das SETTING kann innerhalb interner Sub-Szenen eines Seedance-Aufrufs VARIEREN. Die Charakteridentität wird durch das Porträt-Referenzbild festgelegt, nicht durch das Setting. Validierte Referenz (ref-01 Bristle UGC, 26s) zeigt denselben Ersteller in 5+ verschiedenen Raum-/Hintergrundeinstellungen innerhalb eines einzigen Multi-Szenen-Renders. Teilen Sie nicht künstlich in mehrere Aufrufe auf, nur um die Räume zu wechseln – backen Sie die Settings-Änderungen IN die SZENE N (X-Ys) Sub-Szenen-Struktur eines einzigen Aufrufs ein. Verteilen Sie Aufrufe basierend auf dem GESCHICHTENBOGEN und dem 15s-Maximaldauer-Limit, nicht nach der Anzahl der Settings. Siehe prompt-example.md für die validierte Vorlage. Gedächtnis: feedback_seedance_long_calls_not_short.md.
0a. KLEIDUNG muss VOLLSTÄNDIG angegeben werden – oben + unten + Haare + Accessoires. Validated 2026-05-23 (Bristle): Wenn nur das Oberteil angegeben ist („creme Sweatshirt"), halluziniert Seedance den unteren Teil (Jeans-Shorts tauchten aus dem Nichts auf). Jeder Prompt muss alle festlegen: -- Oberteil (mit Verneinungen) -- Unterteil (mit Verneinungen) – „helle Jeans-Shorts, bis zur Mitte des Oberschenkels, KEINE Jeans, KEINE Pyjama-Shorts" -- Haare (spezifisches Styling – „lockerer, tiefer Pferdeschwanz im Nacken mit Gesichtsrahmen-Strähnen" funktioniert besser als vages „Dutt") -- Accessoires (z. B. „dünne goldene Creolen, sonst nichts")
Für Bekenntnis-/Einzelgespräch-UGC sollte die Kleidung bei allen Aufrufen derselben Anzeige IDENTISCH sein (validierte Benutzerpräferenz + ref-01 + ad-03 Muster). Variieren Sie die Kleidung über Aufrufe hinweg NUR für GRWM / Transformation / mehrtägige Formate. Gedächtnis: feedback_seedance_long_calls_not_short.md.
0b. ÜBERGEBEN SIE EIN HINTERGRUND-REFERENZBILD als image_urls[2] für festgelegte Settings. Validated 2026-05-23 (Bristle). Nur Textbeschreibung des Settings führt zu generischer Mietwohnungs-Ästhetik – Seedance füllt mit seinem eigenen Raum-Hintergrund. Ein Hintergrund-Heldenbild (generiert mit NB2 Pro unter fal-ai/nano-banana-pro, $0.15/1K, Text-zu-Bild mit „kein Bokeh, unendliche Schärfe, keine Personen, keine Gesichter"-Anweisungen) SPERRT den Raum über alle Sub-Szenen hinweg. Verwenden Sie das GLEICHE Hintergrundbild für alle Aufrufe derselben Anzeige – ein anderes Hintergrundbild pro Aufruf wirkt, als ob „sie umgezogen wäre." Gedächtnis: feedback_seedance_long_calls_not_short.md.
0c. REINIGEN SIE PRODUKT-REFERENZBILDER VORAB mit NB2-Bearbeitung, wenn sie Accessoires enthalten. Validated 2026-05-23 (Bristle hi_res-12 hatte Fläschchen + Trichter neben der Schachtel; Seedance verschmolz sie auf die Schachtelfläche). Überprüfen Sie Quellproduktbilder beim Import. Wenn Accessoires / Sekundärprodukte / Bewertungsabzeichen / Lifestyle-Elemente sichtbar sind, leiten Sie sie durch fal-ai/nano-banana-2/edit ($0.08), um das Heldenprodukt zu isolieren, bevor Sie es an Seedance übergeben. Günstiger als ein erneuter Versuch eines $4.50-$10.20 Seedance-Renders. Gedächtnis: feedback_nb2_clean_product_refs.md.
0d. SEQUENZIELLE AUFRUFKONTINUITÄT – verwenden Sie Seed-Wiederverwendung, NICHT video_urls. Validated 2026-05-23 (Bristle Variant A/B-Test). Übergeben Sie für Aufruf N>1 in einer Mehrfachaufruf-Anzeige den Seed (--seed) des vorherigen Aufrufs mit denselben image_urls. Übergeben Sie NIEMALS das MP4 des vorherigen Aufrufs als video_urls für sequenzielle Kontinuität – es SCHADET der Kontinuität (das Modell versucht, das vorherige Video „fortzusetzen"; Kleidung/Produkt driften stärker ab, als sie es sonst tun würden). video_urls sind NUR für die Stilübertragung von einem ECHTEN MENSCHLICHEN Referenzvideo (z. B. eine echte Ersteller-UGC-Anzeige nehmen und mit KI-Ersteller nachbilden). Gedächtnis: feedback_seedance_video_urls_vs_seed.md.
0e. BEI VERWENDUNG VON video_urls (Stilübertragung von realer Referenz): setzen Sie das Client-Timeout auf 30+ min UND kürzen Sie die Referenz auf ≤15s. Validated 2026-05-23:
- Renderzeit: ~18-20 Min (vs ~10 Min für Nur-Bild). Das Standard-
fal_client.subscribe()10-Minuten-Timeout schlägt fehl. Verwenden Siefal_client.submit()+ manuelles Polling. - Kombiniertes
video_urlsDauerlimit: 15s. FAL lehnt mitinput_value_error: Combined video duration must not exceed 15.0sab. Kürzen Sie Referenzvideos mit ffmpeg-t 15vor dem Hochladen. - Kombiniertes Dateilimit: 50 MB gesamt. Unser
fal_helpers.upload_file()-Limit wurde am 2026-05-23 von 10 MB auf 50 MB erhöht. - Erkennen Sie Validierungsfehler (
input_value_error/ „must not exceed") in Polling-Ausnahmen und brechen Sie nach 1-2 Wiederholungen ab – terminale Fehler werden nicht überstatus=Failedangezeigt. - Video-Referenz überträgt MEHR als nur Stil/Tempo – sie überträgt Kleidungsstil, Accessoires und Haare in erheblichem Maße (validated 2026-05-23 Probiotic Recreation: Haare wechselten, um der Referenz zu entsprechen; Tabletten erschienen trotz gereinigtem Produktbild). Textseitige Überschreibungen sind TEILWEISE wirksam; wählen Sie eine Referenz, deren Optik bereits mit Ihrem Ziel übereinstimmt.
- FAL AKZEPTIERT KI-generiertes Video als Eingabe (die alte „instant content_policy_violation"-Annahme von BBE 2026-05 ist veraltet). Gedächtnis:
feedback_seedance_video_urls_vs_seed.md.
1. Übergeben Sie NIEMALS KI-generiertes Video als video_urls. Der Content-Policy-Validator von FAL lehnt dies mit partner_validation_failed ab. Der 60% Rabatt für Videoeingaben ist zwar echt, gilt aber NUR für ECHTE MENSCHLICHE Referenzvideos. Verwenden Sie für die KI-Avatar-Kontinuität über mehrere Szenen hinweg dasselbe Identitätsporträt als image_urls in jeder Szene. Validated auf BBE.
2. NSFW-Ablehnung → STOPPEN und melden, nicht automatisch wiederholen. Körperanwendung + weiblich + Wasser/Schaum trifft den Klassifikator zuverlässig. Wenn FAL content_policy_violation oder status: failed mit nsfw-Grund zurückgibt, wiederholen Sie NICHT denselben Prompt. Melden Sie den Fehler an den Aufrufer mit 3 Optionen: den Anwendungsschlag als Geruchstest / Fingerspitzen zeigen umschreiben, als POV (kein Gesicht) neu rahmen oder die Szene überspringen. Folgt der projektweiten Moderationsrichtlinie (siehe Gedächtnis feedback_hf_moderation_surface.md).
3. duration als INT. Übergeben Sie 15, nicht "15". seedance-2.0/reference-to-video lehnt eine String-Dauer mit invalid_request ab (validiert am 2026-07-18; die alte „nur String"-Notiz war der veraltete v1 i2v-Endpunkt).
4. Ein Produkt pro Aufruf (außer Hook). Multi-Produkt-Hero-Szenen innerhalb eines einzigen Seedance-Aufrufs beeinträchtigen die Etikettenwiedergabetreue. Die Ausnahme ist die Hook-/Intro-Szene, in der alle Produkte zusammen erscheinen, aber kein einzelnes Etikett das Hero ist.
5. 1080p für Hero-Qualität. Hautstruktur und Produktetikettenschärfe skalieren merklich mit der Auflösung. Verwenden Sie 720p nur für Budget-/Testaufrufe.
Arbeitsablauf
python3 scripts/generate.py \
--prompt "$(cat prompt-scene-1.txt)" \
--output /pfad/zu/szene-1.mp4 \
--image-url "https://<gehostet>/portrait.png" \
--image-url "https://<gehostet>/product.png" \
--resolution 1080p \
--duration 15 \
--aspect-ratio 9:16 \
--generate-audio
Das Skript:
- Wird über den mitgelieferten
media_proxy.py(GooseWorks FAL-Proxy) abgewickelt – kein FAL-Schlüssel; belastet den Ads-Agent über~/.gooseworks/credentials.json. - Übergibt die
--image-url-Werte direkt alsimage_urls(sie müssen bereits ÖFFENTLICHE URLs sein; der Orchestrator hostet lokale Referenzen über MCP). - Sendet
bytedance/seedance-2.0/reference-to-videodurch den Proxy und fragt bis zum Abschluss ab mit:{ "prompt": <prompt>, "image_urls": [<refs>], "resolution": <res>, "duration": <dur>, # int "aspect_ratio": <ar>, "generate_audio": <bool>, "seed": <optional int>, } - Lädt das Ergebnis-MP4 nach
--outputherunter. - Schreibt
<output>.meta.jsonmit Prompt, Referenzen, Video-URL, Seed, Dauer, Kostenschätzung. - Bei
content_policy_violationoder NSFW-Fehler: zeigt den Fehler an und beendet mit einem Nicht-Null-Exit-Code (keine stillen Wiederholungen).
Ausgabe
<output>– MP4-Clip mit angeforderter Dauer, Auflösung, Seitenverhältnis.<output>.meta.json– Anfrage + Ergebnis-Metadaten + Seed für Reproduzierbarkeit + Kostenschätzung.
Preise (2026-05)
| Auflösung | Dauer | Kosten pro Aufruf |
|---|---|---|
| 720p std | 15s | ~$4.54 |
| 1080p std | 15s | ~$10.20 |
| 1080p std | 8s | ~$5.44 |
| 1080p std | 4s | ~$2.72 |
Die schnelle Stufe ist etwa 20% günstiger, ist aber auf 720p begrenzt.
Prompt-Vorlage
Der Prompt ist der mit Abstand größte Qualitätshebel. Verwenden Sie die bewährte BBE-Vorlagenstruktur:
📱 UGC INFLUENCER [PRODUKT] BEWERTUNGS-REEL (SELFIE-STIL, KEINE WERBUNG)
[BLOCK 0 — Anti-Pattern-Eröffnung]
Dies ist KEINE filmische Werbung, KEINE [Kategorie]-Anzeige, KEIN redaktioneller Beitrag.
Dies ist ein echtes Instagram-Reel, gefilmt von einem [demografische Gruppe] Creator in seinen
Zwanzigern mit der Frontkamera des iPhones, der in einem entspannten, vertraulichen Ton direkt
mit seinen Followern spricht...
[BILDREFERENZ-ZUWEISUNGEN]
Verwenden Sie @Image1 als Gesicht/Identität des Influencers. Verwenden Sie @Image2 als das
genau [Produkt], das er bewertet – es ist eine [VISUELLE BESCHREIBUNG]. Es ist KEINE [häufige
Verwechslung]. Das Produkt und das Etikett MÜSSEN klar erkennbar sein.
[FORMAT-Block]
- Vertikale 9:16 Handy-Selfie-Ästhetik, leichter Handheld-Mikro-Wackler
- KLEIDUNG (STRENG): [Kleidung]. ABSOLUT NICHT [Liste der Verneinungen].
- Setting: [Setting]
- Beleuchtung: [Beleuchtung]
- Echte, leicht unvollkommene Haut (natürlich, kaum Make-up), helle goldene Bräune
[IDENTITÄTS-Block]
Dieselbe junge Frau wie @Image1 — [Altersbereich, Haare, Augen, Hautton]
[DYNAMISCHER BILDAUSSCHNITT-Block]
Das Video muss seinen Bildausschnitt über die Szenen hinweg variieren wie ein echtes Reel –
bleiben Sie NICHT die ganze Zeit auf einer Brennweite. Mischen Sie Weitwinkel / Mittel / Nahaufnahmen.
[SZENE 1 (0-3s)] WEITER HOOK — [Textzeile] + [Emotion + Aktion]
[SZENE 2 (3-7s)] PRODUKT HERO mit Drehung — [Textzeile] + [Emotion + Aktion]
[SZENE 3 (7-11s)] SEITENSCHRITT Anwendung oder Geruchstest — [Textzeile] + [Emotion + Aktion]
[SZENE 4 (11-15s)] REAKTION + Empfehlung — [Textzeile] + [Emotion + Aktion]
[AUDIO-ANWEISUNG]
[Stimme: Ton, Akzent, Tempo pro DELIVERY_STYLES.md]
KEINE Musik im Audio (wir fügen Musik in der Nachbearbeitung hinzu).
[GLOBALE REGELN]
- Kleidung identisch in der gesamten Szene
- Das Produkt bleibt identisch und deutlich sichtbar in ihrer Hand
- Lippen zwischen den Dialogschlägen GESCHLOSSEN bleiben
- [NSFW Ausweichverneinungen falls relevant]
[STRENGE REALISMUS-REGELN — Block F]
- Winzige natürliche Unvollkommenheiten, leichter Pfirsichflaum, feine Fältchen
- NICHT plastik, NICHT luftgebürstet, NICHT puppenartig, NICHT porzellan
- Haut-Highlights NUR auf Nasenspitze, Wangenknochen, Amorbogen
- Haare: einzelne fliegende Härchen
…
[für die Übersetzung gekürzt]