hiapi-seedance-2-0-ugc-ad-video-skill

HiAPI Seedance 2.0 UGC 廣告影片

建立具有創作者真實展示產品感的垂直產品廣告，同時讓每一項產品宣稱、人物肖像與最終產出成品皆可稽核。

重用已安裝的 hiapi-seedance-2-0-video 實作來進行酬載驗證、任務提交、輪詢與下載。請勿重寫 HiAPI 傳輸層。此技能新增了 UGC 研究、腳本編寫、參考素材、廣告活動變體與品質檢查（QC）層。

嚴格限制

• 僅在使用者提供影像、或識別出已核准的素材並確認其肖像使用權限時，才能使用真實人物的影像。不得模仿名人、公眾人物、客戶或創作者的推薦背書。
• 在簡報中將生成的演員標示為「合成演員」。不得將合成的表演呈現為未經腳本安排的客戶見證。
• 所有的產品益處、規格、價格、折扣、比較與效果，都必須根植於使用者提供的材料或當前主要來源。不得捏造評論、使用歷史、使用前/後效果、稀缺性或個人體驗。
• 將健康、醫療、保健食品、減重、金融、酒精、賭博及其他受管制類別視為需要審查的項目。在產出最終廣告文案前，請檢查當前官方平台與司法管轄區的規則。
• 請勿在生成的影片內放置未經驗證的文字、標籤、價格或徽章。僅在確認音訊內容後，才能在後製階段加入字幕和優惠文字。
• 除非使用者明確要求此類獨立操作，否則不得公開發佈、排程或上傳。
• 除非獲得明確的成本確認，否則請勿以 4k 解析度生成或使用付費持久儲存空間。

預設值

當請求未指定時，使用以下預設值：

• 平台：TikTok 與 Instagram Reels
• 長寬比：9:16
• 長度：10 秒
• 解析度：草稿使用 720p；當使用者要求交付品質時使用 1080p
• 音訊：啟用 Seedance 原生對話
• 結構：一段連續手持拍攝，包含四個微節拍
• 語言：符合使用者或其指定的目標市場
• 儲存：暫存輸出，下載至本地
• 批次：三個獨立創意變體，而非一個過度負載的多剪輯生成

保持每個 Seedance 任務在 4 到 15 秒之間。對於 20–30 秒的廣告，規劃兩個或三個獨立有效的片段，並在每個片段都通過 QC 後再進行組裝。

工作流程

1. 建立具根據的產品簡報

僅收集或推斷安全的創意選擇：

• 產品名稱、類別、URL 與清晰的產品圖片
• 目標買家、問題、差異化優勢、優惠方案與 Call to Action (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. 選擇一個創意角度

在選擇格式、節拍時間、真實性訊號、批次變體或平台適應方式時，請參閱 references/ugc-playbook.md。

每個廣告選擇一個承諾。優先選擇可見的產品動作而非形容詞：

• 開箱一個包裹
• 使用產品一次
• 展示一個控制項或功能
• 僅在有真實證據時比較一個使用前/使用後狀態
• 提出一個益處與一個 CTA

使用口語鉤子，而非生成的覆蓋文字。將可選的短鉤子覆蓋層與字幕留給後期製作。

對於活動批次，一次僅改變一個維度：

• 鉤子 A：痛點識別
• 鉤子 B：意想不到的發現
• 鉤子 C：產品為主的視覺揭曉

保持整批的產品事實、優惠方案、演員權益與 CTA 來源一致。

3. 為自然口語編寫腳本

使用符合目標市場的縮寫、停頓、自我修正與簡單詞彙。避免精緻的品牌文案節奏。

使用以下口語預算：

• 英文：目標約為每秒 2.0–2.8 個單詞
• 中文：目標約為每秒 3.5–5.0 個口語字元

使用以下預設節拍地圖來建構一個 10 秒的廣告：

1. 0.0–1.5秒 — 口語或視覺鉤子；產品已可見
2. 1.5–4.0秒 — 開箱、塗抹、穿戴或將產品移近
3. 4.0–8.0秒 — 示範一個有來源的功能或可見效果
4. 8.0–10.0秒 — 自然反應與一個 CTA

除非宣稱清單支持且演員被授權這麼說，否則不得聲稱「我已經用了好幾週」、「這治癒了」、「每個人都愛」或類似的經驗/效果語言。

4. 選擇 Seedance 媒體模式

僅使用一種模式：

1. 首幀圖像 — 最佳控制。使用一張已驗證的 9:16 圖片，其中已顯示經核准的演員與確切的產品。透過 production.first_frame_url 或 production.first_frame_path 傳遞。
2. 多模態參考 — 使用獨立的經核准演員圖片與產品圖片。將它們放入 production.reference_image_urls 或 production.reference_image_paths。
3. 純文字 — 僅用於通用概念草稿。警告產品、包裝與演員保真度會較低。

不要混合使用首/尾幀輸入與多模態參考。保持演員身份、產品幾何形狀、包裝顏色、瓶蓋方向、標籤位置與經核准的服裝穩定。

如果需要先建立一張英雄圖像，請使用可用的圖片編輯技能，並參考演員與產品參考資料，然後在調用 Seedance 之前目視檢查原始解析度的影像。請勿接受包裝突變、偽造文字、多餘手指或臉部改變的圖像。

5. 指導表演

讓 Seedance 提示詞包含：

• 確切長度、9:16 與單鏡拍攝或片段拓撲
• 用引號括起來的確切核准對話
• 產品起始位置與每個節拍的主要身體動作
• 放鬆的視線、小幅手勢、自然的眨眼、呼吸與微停頓
• 手持手機感、輕微的自動對焦/曝光呼吸、真實的皮膚質感、普通室內光線與適度的背景細節
• 有用的原生聲音：對話、環境音、包裝撕開/按壓聲或產品使用音
• 負面限制：除非有計畫，否則無剪輯、無美顏濾鏡、無演員漂移、無產品突變、無重複產品、無發明的標籤文字、無多餘手指、無無關標誌、無字幕、無浮水印

除非簡報明確要求製作精緻的混合廣告，否則避免「電影感的商業廣告」、完美對稱、奢華影棚燈光、激進的推軌鏡頭或模特兒式的擺拍。

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 內部轉換為 data URI，因此大型參考資料不會透過 shell 參數傳遞。審閱經過編輯的酬載並確認：

• model 為 seedance-2.0
• duration 為 4–15
• ratio 為 9:16
• resolution 符合預期
• generate_audio 與簡報相符
• 僅存在一種媒體模式
• 僅包含經核准的參考資料

7. 僅在要求時才生成

對於實際的影片請求，需要在環境變數中設定 HIAPI_API_KEY，然後執行：

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

如果使用者只要求概念、腳本、提示詞或製作計畫，請在此命令前停止並返回完整的簡報。

對於批次任務，每個變體使用一個簡報，並保持一個穩定的活動 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 推斷成功。

下載後：

1. 使用 ffprobe 檢測 MP4 檔案；記錄長度、尺寸、幀率、編解碼器與音訊存在與否。
2. 取出開場、示範與最終幀。
3. 檢查臉部身份、手部、嘴巴、產品幾何形狀、包裝、標籤、產品數量與背景連續性。
4. 聆聽完整音訊或進行轉錄。驗證語言、清晰度、嘴型同步、產品聲音與完整的 CTA。
5. 拒絕帶有偽造文字、剪輯語音、臉部漂移、手部變形、產品突變、揭露衝突或缺少可見示範的輸出。
6. 僅在原始生成通過後，才加入平台字幕、安全區域文字、音樂或 CTA 覆蓋層。

如果出現任何核心產品或肖像缺陷，請從更清晰的參考圖像或簡化動作重新生成。請勿透過裁切來隱藏重大缺陷。

輸出內容規範

以使用者的語言回傳以下章節：

1. 假設事項
2. 產品來源與宣稱清單
3. 選擇的 UGC 格式與受眾角度
4. 鉤子變體
5. 附時間節拍的最終腳本
6. 參考素材計劃
7. 可直接複製的 Seedance 提示詞
8. 驗證過的酬載或確切執行命令
9. 合規與揭露備註
10. QC 結果
11. 成品路徑 — 僅在真實檔案存在後

對於生成的結果，需區分 已建立、仍在處理中、失敗與 已下載。在沒有真實的本地檔案或經過驗證的遠端結果 URL 之前，切勿聲稱「完成」。

資源

• 參閱 references/ugc-playbook.md 以了解格式選擇、時間安排、提示詞模式、批次設計與 QC。
• 參閱 references/github-foundations.md 以稽核或更新此技能的開源基礎。
• 複製 assets/ugc-brief.example.json 作為機器可檢查的簡報。
• 在每次付費生成前執行 scripts/validate-ugc-brief.mjs。
• 執行 scripts/run-ugc-seedance.mjs 以進行酬載空運行與實際的 HiAPI 執行。