create-video-seedance-2-fal

⚠️ REQUIRED PREFLIGHT (2026-06-04): every Seedance prompt that names a branded product MUST be paired with a real reference image of that exact product as one of the --image-ref inputs. Text-only product description without a ref invites Seedance to invent geometry that does not match the real SKU. If no reference exists locally, find one via brand-assets → existing-ads → PDP harvest → promote to clients/<brand>/brand-assets/reference-photos/. Optionally clean an occluded ref via a quick GPT-image-2 edit pass first. Always get user review of the reference + final prompt before firing the paid call. See feedback_product_reference_required.md.

Purpose

Wraps the FAL endpoint bytedance/seedance-2.0/reference-to-video. Pass 1-N image references (typically: portrait + product + optional setting) + a structured prompt → get back a 4-15s clip with native lip-synced VO and ambient audio.

Seedance 2.0 renders multiple internal cuts within a single 15s call when the prompt specifies sub-scene structure (e.g. WIDE HOOK / PRODUCT HERO / SIDESTEP / REACTION). This is the architectural win over the older NB2 + i2v multi-keyframe approach — fewer calls, native lip-sync, no Soul ID required.

Use this atom when:

• The clip needs a talking-head avatar reviewing or demonstrating a product
• Native lip-synced dialogue is required (set --generate-audio)
• Identity must hold via image reference, not video reference (see Decision Rule 1)
• Length 4-15s, vertical 9:16 (or other aspect ratios)
• Multi-image conditioning (face + product, or face + multiple products for a hook scene)