create-video-seedance-2-fal
⚠️ 必須の事前チェック (2026-06-04): ブランド製品を指定する Seedance プロンプトには、必ずその製品の実際の参照画像を
--image-ref入力の1つとしてペアにしてください。 テキストのみの製品説明では、Seedance が実物の SKU と一致しない形状を生成する可能性があります。ローカルに参照画像がない場合は、brand-assets → existing-ads → PDP ハーベスト →clients/<brand>/brand-assets/reference-photos/に昇格させて見つけてください。オプションで、事前に GPT-image-2 編集パスで隠れた参照をクリーンにすることもできます。有料呼び出しを実行する前に、必ず参照と最終プロンプトについてユーザーのレビューを得てください。 詳細はfeedback_product_reference_required.mdを参照。
目的
FAL エンドポイント bytedance/seedance-2.0/reference-to-video をラップします。1~N枚の画像参照(典型的には:ポートレート+商品+オプションの背景)+構造化プロンプトを渡すと、4~15秒のクリップ(ネイティブのリップシンク音声と環境音付き)が返ってきます。
Seedance 2.0 は、プロンプトがサブシーン構造(例:WIDE HOOK / PRODUCT HERO / SIDESTEP / REACTION)を指定すると、単一の15秒呼び出し内で複数の内部カットをレンダリングします。これが、古い NB2 + i2v マルチキーフレーム方式に対するアーキテクチャ上の勝利です — 呼び出し回数が減り、ネイティブのリップシンクが可能になり、Soul ID が不要になります。
このアトムは以下の場合に使用します:
- クリップに、製品をレビューまたはデモするトーキングヘッドのアバターが必要な場合
- ネイティブのリップシンク付きダイアログが必要な場合(
--generate-audioを設定) - 動画参照ではなく画像参照によってアイデンティティを保持する必要がある場合(決定ルール1を参照)
- 長さ4~15秒、縦型9:16(または他のアスペクト比)
- マルチ画像コンディショニング(顔+商品、またはフックシーン用の顔+複数商品)
使用しないでください:
-
15秒のクリップ → 複数の呼び出しに分割して結合(
assembly/stitch-videos-ffmpeg) - 画面上の人物がいない純粋な映画的なカメラワーク → 多くの場合
create-video-veo3の方が適切 - 人物なしの商品のみのBロール →
create-product-videos-higgsfield-msまたはテキスト-to-ビデオ Seedance - 以前のAI生成シーンからの連続性のために動画参照が必要なクリップ → サポートされていません(content_policy_violation)
入力
必須:
--prompt— 構造化プロンプトブロック(下記「プロンプトテンプレート」を参照)。長く、複数ブロック。実行例:beauty-by-earth/video-01-three-product-grwm/working/fire_seedance_facewash.py。--output— ローカルの MP4 出力先。--image-url(エイリアス--image-ref) — 少なくとも1つの公開参照画像URL(繰り返し可能)。image_urlsとして渡されます。順序が重要 — 最初の画像がプロンプト内で@Image1としてアドレス指定されます。プロキシはローカルファイルをアップロードしません:MCPget_upload_url→get_download_url経由でローカル参照をホストし、URL を渡します(create-video-falと同一)。
オプション:
--resolution—480p|720p|1080p(デフォルト)。1080p は製品ラベルの忠実度に有意に優れています。--duration—4~15秒(デフォルト15)。整数として渡します(seedance-2.0/reference-to-videoの enum {auto,4..15})。文字列の "15" はinvalid_requestで拒否されます(2026-07-18 確認)。--aspect-ratio—9:16(デフォルト)、16:9、1:1など。--generate-audio— ブール値、デフォルト true。後で VO を追加するサイレント Bロールの場合は false に設定。--seed— 決定論的再実行のための整数(FAL がシードを返します;それを渡して再現)。
認証情報:
- FAL キーは不要。 GooseWorks FAL プロキシ(
media_proxy.py、バンドル済み)経由でルーティングされ、Ads エージェントに課金します。~/.gooseworks/credentials.json(gooseworksCLI によって書き込まれる)を使用します。あなたのcal_/エージェントトークンは FAL キーではありません — 古い直接キーパスは 401 エラーになりました;そのため、この機能はプロキシ経由で再ルーティングされました。
決定ルール
0. 多くの短い呼び出しよりも、内部マルチシーンプロンプトを使用したより少なく、より長い呼び出しを優先します。 新しい Seedance 呼び出しごとに、キャラクター、ワードローブ、照明、背景がわずかにずれます — 同じポートレート参照を使用しても同じです。5回の短い呼び出し = 視聴者が連続性の断絶として認識する5つのずれポイントになります。実績のあるマルチシーンテンプレートを1回の10~15秒の呼び出し内で使用して、1回のレンダリングから内部でハードなカットを取得します:
SCENE 1 (0-3s) — WIDE HOOK [フレーミング + アクション + ダイアログ]
SCENE 2 (3-7s) — PRODUCT HERO [フレーミング + カメラワーク + ダイアログ]
SCENE 3 (7-11s) — SIDESTEP / 証拠 [フレーミング + アクション + ダイアログ]
SCENE 4 (11-15s) — REACTION + CTA [フレーミング + アクション + ダイアログ]
設定は Seedance の1回の呼び出し内の内部サブシーン間で変化させることができます。 キャラクターのアイデンティティはポートレート参照画像によって固定され、設定によって固定されるわけではありません。検証済みの参照(ref-01 Bristle UGC、26秒)は、単一のマルチシーンレンダリング内で、同じクリエイターが5つ以上の異なる部屋/背景設定にわたって表示されることを示しています。部屋を変えるためだけに人為的に複数の呼び出しに分割しないでください — 設定変更を1回の呼び出しの SCENE N (X-Ys) サブシーン構造に組み込んでください。呼び出しは、設定数ではなく、ストーリーアークと15秒の最大時間制限に基づいて分散してください。検証済みのテンプレートについては prompt-example.md を参照。記憶:feedback_seedance_long_calls_not_short.md。
0a. ワードローブは完全に指定すること — トップス + ボトムス + 髪型 + アクセサリー。 2026-05-23(Bristle)で検証:トップスだけが指定された場合(「クリーム色のスウェットシャツ」)、Seedance はボトムスを幻覚しました(デニムのショートパンツがどこからともなく現れた)。すべてのプロンプトは以下をすべてロックする必要があります:
- トップス(否定付き)
- ボトムス(否定付き) — 「ライトデニムのカフスショートパンツ、太もも半ば、ジーンズではない、パジャマショーツではない」
- 髪型(具体的なスタイリング — あいまいな「お団子」よりも「後ろ首元でゆるいローポニーテール、顔周りのストランド」の方が効果的)
- アクセサリー(例:「細いゴールドフープイヤリング、他には何もなし」)
告白調/単一セッションのUGCの場合、ワードローブは同じ広告のすべての呼び出しで同一である必要があります(検証済みのユーザー設定 + ref-01 + ad-03 パターン)。GRWM/変身/複数日フォーマットの場合にのみ、呼び出し間でワードローブを変えてください。記憶:feedback_seedance_long_calls_not_short.md。
0b. 固定設定のために背景参照画像を image_urls[2] として渡します。 2026-05-23(Bristle)で検証。テキストのみの設定説明では、一般的なレンタル物件の美学が得られます — Seedance は独自の部屋の事前分布で埋めます。背景のヒーロー画像(fal-ai/nano-banana-pro で NB2 Pro を使用して生成、$0.15/1K、「ボケなし、無限ピント、人物なし、顔なし」の指示付きテキスト-to-画像)は、すべてのサブシーンにわたって部屋をロックします。同じ広告のすべての呼び出しで同じ背景画像を使用します — 呼び出しごとに異なる背景画像は「彼女が移動した」と認識されます。記憶:feedback_seedance_long_calls_not_short.md。
0c. アクセサリーを含む製品参照画像は、NB2 編集で事前にクリーンにします。 2026-05-23(Bristle hi_res-12 では、箱の横にバイアル+ロートがありました;Seedance がそれらを箱の表面に融合させました)で検証。製品元画像を受領時に検査します。アクセサリー/副製品/スコアバッジ/ライフスタイル要素が見える場合は、Seedance に渡す前に fal-ai/nano-banana-2/edit($0.08)にルーティングしてヒーロー製品を分離します。$4.50~$10.20 の Seedance レンダリングをやり直すより安価です。記憶:feedback_nb2_clean_product_refs.md。
0d. 連続呼び出しの連続性 — シード再利用を使用し、video_urls は使用しないでください。 2026-05-23(Bristle バリアント A/B テスト)で検証。マルチ呼び出し広告の呼び出し N>1 の場合、同じ image_urls で前の呼び出しの seed を(--seed 経由で)渡します。連続性のために、前の呼び出しの mp4 を video_urls として渡してはいけません — 連続性を悪化させます(モデルが前の動画を「継続」しようとし、ワードローブ/製品がそうでない場合よりも大きくずれます)。video_urls は、実際の人間の参照動画からのスタイル転送にのみ使用します(例:実際のクリエイターの UGC 広告を取得し、AI クリエイターで再作成)。記憶:feedback_seedance_video_urls_vs_seed.md。
0e. video_urls を使用する場合(実際の参照からのスタイル転送):クライアントタイムアウトを30分以上に設定し、参照を≤15秒にトリミングします。 2026-05-23 で検証:
- レンダリング時間:約18~20分(画像のみの約10分と比較)。デフォルトの
fal_client.subscribe()の10分タイムアウトは失敗します。fal_client.submit()+ 手動ポーリングを使用します。 video_urlsの合計時間制限:15秒。 FAL はinput_value_error: Combined video duration must not exceed 15.0sで拒否します。アップロード前に ffmpeg-t 15で参照動画をトリミングします。- 合計ファイルサイズ制限:合計50 MB。
fal_helpers.upload_file()の制限は2026-05-23に10 MBから50 MBに増加しました。 - 検証エラー(
input_value_error/