HiAPI Seedance 2.0 UGC広告動画は何をしますか？

クリエイターが実際に商品を実演しているように感じられる縦型商品広告を作成し、すべての製品クレーム、肖像、出力成果物を監査可能にします。

インストール済みの hiapi-seedance-2-0-video 実装を再利用して、ペイロードの検証、タスク送信、ポーリング、ダウンロードを行います。HiAPIトランスポートを書き換えないでください。このスキルは、UGCリサーチ、スクリプト作成、参照アセット、キャンペーンバリエーション、QCのレイヤーを追加します。

ハードゲート

実在人物の画像は、ユーザーが提供した場合、または承認済みアセットを特定し、その肖像を使用する許可を確認した場合にのみ使用します。有名人、公人、顧客、クリエイターの推薦を模倣しないでください。
生成されたアクターは、ブリーフ内で合成であると明示します。合成パフォーマンスを台本なしの顧客の声として提示しないでください。
ベネフィット、仕様、価格、割引、比較、結果は、ユーザーの資料または現在の一次情報源に基づきます。レビュー、使用履歴、ビフォー/アフターの結果、希少性、個人的な経験を作り出さないでください。
健康、医療、サプリメント、減量、金融、アルコール、ギャンブル、その他の規制対象カテゴリは、レビュー必須として扱います。最終的な広告コピーを作成する前に、現在の公式プラットフォームおよび管轄区域のルールを確認します。
未確認のテキスト、ラベル、価格、バッジを生成された動画内に配置しないでください。吹き出し音声を確認した後、ポストプロダクションでのみキャプションとオファーテキストを追加します。
ユーザーが明示的にその個別アクションを要求しない限り、公開、スケジュール設定、アップロードを行わないでください。
明示的なコスト確認なしに、4k での生成や有料の永続ストレージを使用しないでください。

デフォルト

リクエストで指定されていない場合は、以下を使用します。

プラットフォーム: TikTok および Instagram Reels
アスペクト比: 9:16
長さ: 10 秒
解像度: ドラフトは 720p、ユーザーが納品品質を要求した場合は 1080p を使用
音声: Seedance ネイティブダイアログ有効
構成: 4つのマイクロビートを持つ、1つの連続したハンドヘルドショット
言語: ユーザーまたはユーザーが指定するターゲット市場に合わせる
ストレージ: 一時的な出力、ローカルにダウンロード
バッチ: 過負荷なマルチカット生成ではなく、3つの独立したクリエイティブバリエーション

各 Seedance タスクは 4 ～ 15 秒に保ちます。20～30秒の広告の場合は、2つまたは3つの独立して有効なクリップを計画し、すべてのクリップが QC を通過した後にのみアセンブルします。

ワークフロー

1. 情報源に基づいた製品ブリーフの構築

安全なクリエイティブな選択のみを収集または推測します。

製品名、カテゴリ、URL、明確な製品画像
ターゲット購入者、問題、差別化要因、オファー、CTA
情報源に基づいたクレーム台帳と禁止クレーム
プラットフォーム、ターゲット市場、言語、長さ、バッチサイズ
フォーマット: 開封披露, 初回使用デモ, カメラ前デモ, 問題解決, 試着, または クリエイター比較
タレントソース: ユーザー提供, 雇用クリエイター, または 合成ジェネリック
承認されたアクター画像、製品画像、ファーストフレームプレート、または参照メディア

表示ページに十分な情報が含まれていない場合は、提供された製品URLを調査します。公式製品ページ、製品マニュアル、確認済みの販売業者リスト、現在の公式ポリシーを優先します。発見した事実とクリエイティブな演出を分離します。

assets/ugc-brief.example.json をタスクワークスペースにコピーし、デモ値を置き換えます。creative.script と creative.seedance_prompt の両方に、正確な話す台詞を保持します。

以下を実行します。

node scripts/validate-ugc-brief.mjs /absolute/path/to/ugc-brief.json

生成前にすべてのエラーを修正します。警告は明示的なレビュー項目として扱います。

2. 1つのクリエイティブ角度を選択

フォーマットの選択、ビートのタイミング、真正性シグナル、バッチバリエーション、プラットフォーム適応については、references/ugc-playbook.md を参照します。

広告ごとに1つの約束を選択します。形容詞よりも目に見える製品アクションを優先します。

1つのパッケージを開封する
製品を1回塗布または使用する
1つのコントロールまたは機能を表示する
実際の証拠が存在する場合のみ、1つのビフォー/アフター状態を比較する
1つのベネフィットと1つのCTAを指定する

生成されたオーバーレイテキストではなく、話すフックを使用します。オプションの短いフックオーバーレイとキャプションはポストプロダクション用に保存します。

キャンペーンバッチの場合、一度に1つのディメンションを変更します。

フックA: 痛みの認識
フックB: 予期せぬ発見
フックC: 製品ファーストのビジュアルリビール

製品の事実、オファー、タレントの権利、CTAはバッチ全体で一貫して維持します。

3. 自然なスピーチのためのスクリプト作成

ターゲット市場に合った短縮形、間、自己修正、簡単な単語を使用します。洗練されたブランドコピーのリズムは避けます。

以下のスピーキング予算を使用します。

英語: 約毎秒 2.0～2.8 ワードを目標とする
中国語: 約毎秒 3.5～5.0 話し言葉の文字を目標とする

以下のデフォルトビートマップで10秒の広告を構築します。

0.0～1.5秒 — 話すまたは視覚的なフック; 製品はすでに見えている
1.5～4.0秒 — 開封、塗布、着用、または製品を近づける
4.0～8.0秒 — 情報源に基づいた1つの機能または目に見える結果を実演する
8.0～10.0秒 — 自然な反応と1つのCTA

クレーム台帳がそれをサポートし、タレントがそれを言う権限がない限り、「私はこれを数週間使用しています」「これは治癒しました」「みんなが大好きです」または同等の経験/結果の言葉を主張しないでください。

4. Seedance メディアモードの選択

正確に1つのモードを使用します。

ファーストフレームプレート — 最高の制御。承認されたタレントと正確な製品がすでに表示されている、確認済みの9:16画像を使用します。production.first_frame_url または production.first_frame_path として渡します。
マルチモーダル参照 — 別の承認済みアクター画像と製品画像を使用します。production.reference_image_urls または production.reference_image_paths に配置します。
テキストのみ — 汎用的なコンセプトドラフトにのみ使用します。製品、パッケージ、タレントの忠実度が低下することを警告します。

ファースト/ラストフレーム入力をマルチモーダル参照と混在させないでください。アクターのアイデンティティ、製品の形状、パッケージの色、キャップの向き、ラベルの配置、承認された衣装を安定させます。

最初にヒーロープレートを作成する必要がある場合は、アクターと製品の参照を使用して利用可能な画像編集スキルを使用し、Seedance を呼び出す前にネイティブ解像度の画像を視覚的に検査します。変異したパッケージ、偽造テキスト、余分な指、変更された顔を含むプレートを受け入れないでください。

5. パフォーマンスの指示

Seedance プロンプトに以下を含めます。

正確な長さ、9:16、ワンショットまたはクリップトポロジー
引用符で囲まれた正確な承認済みダイアログ
製品の開始位置とビートごとの1つの支配的な物理的アクション
リラックスしたアイライン、小さな手のジェスチャー、自然なまばたき、呼吸、マイクロポーズ
ハンドヘルド電話の感触、わずかなオートフォーカス/露出の呼吸、リアルな肌のテクスチャ、普通の部屋の明かり、控えめな背景の詳細
有用なネイティブサウンド: ダイアログ、部屋のトーン、パッケージの破れ/クリック、または製品使用音
ネガティブ制約: 計画がない限りカットなし、美容フィルターなし、アクターのドリフトなし、製品の変異なし、重複製品なし、発明されたラベルテキストなし、余分な指なし、無関係なロゴなし、字幕なし、透かしなし

ブリーフが明示的に洗練されたハイブリッド広告を要求しない限り、「シネマティックコマーシャル」、完璧な対称性、豪華なスタジオ照明、アグレッシブなドリーショット、モデルのようなポーズを避けます。

6. 実際のペイロードのドライラン

インストールされている隣接スキルを以下の順序で特定します。

~/.codex/skills/hiapi-seedance-2-0-video-skill
~/.codex/skills/hiapi-seedance-2-0-video
HIAPI_SEEDANCE_SKILL_DIR (明示的に設定されている場合)

このスキルディレクトリからラッパーを実行します。

node scripts/run-ugc-seedance.mjs /absolute/path/to/ugc-brief.json --dry-run

ラッパーは隣接スキルのテスト済みペイロードビルダーをインポートします。Node内でローカルメディアパスをデータURIに変換するため、大きな参照がシェル引数を介して渡されることはありません。編集されたペイロードを確認し、以下を確認します。

モデルは seedance-2.0
長さは 4～15
比率は 9:16
解像度は意図通り
generate_audio がブリーフと一致する
正確に1つのメディアモードが存在する
承認された参照のみが存在する

7. リクエストされた場合のみ生成

実際の動画リクエストの場合は、環境に HIAPI_API_KEY が必要です。その後、以下を実行します。

node scripts/run-ugc-seedance.mjs /absolute/path/to/ugc-brief.json

ユーザーがコンセプト、スクリプト、プロンプト、または制作計画のみを要求した場合は、このコマンドの前に停止し、完全なブリーフを返します。

バッチの場合は、バリエーションごとに1つのブリーフを使用し、安定したキャンペーンIDとバリエーションラベルを保持します。意図された角度を変更します。製品クレームを黙って変更しないでください。現在のHiAPI Seedance 2.0タスクスキーマは、クライアントから提供された seed を受け入れません。

ランナーは、タスク作成直後にHiAPIタスクIDを出力します。ポーリングまたはダウンロードが一時的なネットワークエラーによって中断された場合は、新しいタスクを作成して課金する代わりに、その正確なタスクを再開します。

node scripts/run-ugc-seedance.mjs /absolute/path/to/ugc-brief.json \
  --resume-task-id "tk-hiapi-..."

8. 成果物の検証

承認されたリクエストやタスクIDから成功を推測しないでください。

ダウンロード後:

ffprobe でMP4をプローブし、長さ、寸法、フレームレート、コーデック、音声の有無を記録します。
オープニング、デモンストレーション、最終フレームを抽出します。
顔のアイデンティティ、手、口、製品の形状、パッケージ、ラベル、製品数、背景の連続性を検査します。
完全な音声を聞くか、文字起こしします。正確な言語、明瞭度、リップシンク、製品音、完全なCTAを確認します。
偽造テキスト、途切れたスピーチ、顔のドリフト、変形した手、製品の変異、開示の矛盾、または目に見えるデモンストレーションの欠如がある出力は拒否します。
生の生成が合格した後にのみ、プラットフォームのキャプション、セーフゾーンテキスト、音楽、またはCTAオーバーレイを追加します。

コア製品または類似性の障害が発生した場合は、よりクリーンな参照プレートから再生成するか、アクションを簡素化します。重大な障害をトリミングで隠さないでください。

出力契約

以下のセクションをユーザーの言語で返します。

前提条件
製品ソースとクレーム台帳
選択されたUGCフォーマットとオーディエンスアングル
フックのバリエーション
タイムビート付き最終スクリプト
参照アセット計画
コピー準備完了のSeedanceプロンプト
検証済みペイロードまたは正確な実行コマンド
コンプライアンスと開示に関する注意事項
QC結果
成果物パス — 実際のファイルが存在する場合のみ

生成結果の場合、作成済み、処理中、失敗、ダウンロード済み を区別します。実際のローカルファイルまたは確認済みのリモート結果URLなしで「完了」とは言わないでください。

リソース

フォーマット選択、タイミング、プロンプトパターン、バッチ設計、QCについては、references/ugc-playbook.md を参照してください。
スキルのオープンソースベースを監査または更新する場合は、references/github-foundations.md を参照してください。
機械チェック可能なブリーフとして、assets/ugc-brief.example.json をコピーしてください。
有料生成の前に、scripts/validate-ugc-brief.mjs を実行してください。
ペイロードのドライランと実際のHiAPI実行には、scripts/run-ugc-seedance.mjs を実行してください。

HiAPI Seedance 2.0 UGC広告動画