HiAPI Seedance 2.0 UGC 广告视频

创建垂直产品广告，使其看起来像是创作者真实地展示产品，同时保持每个产品声明、肖像和输出工件的可审计性。

复用已安装的 hiapi-seedance-2-0-video 实现进行负载验证、任务提交、轮询和下载。不要重写 HiAPI 传输层。本技能增加了 UGC 调研、脚本编写、参考资产、广告变体和质量检查层。

硬性限制

仅当用户提供了真实人物的图像、或用户指定了已批准的资产并确认使用该肖像的权限时，才能使用该图像。不要模仿名人、公众人物、客户或创作者的背书。
在简报中将生成的演员标记为“合成”。不要将合成的表演呈现为未经脚本编辑的客户评价。
将产品的优点、规格、价格、折扣、比较和结果建立在用户提供的材料或当前主要来源之上。不要编造评论、使用历史、前后效果、稀缺性或个人体验。
将健康、医疗、保健品、减肥、金融、酒类、赌博及其他受监管类别视为需要审查。在制作最终广告文案之前，请检查当前官方平台和司法管辖区的规则。
不要在生成的视频中放置未经核实文字、标签、价格或徽章。仅在验证了生成的音频后，在后期制作中添加字幕和优惠文字。
除非用户明确要求该独立操作，否则不要发布、安排或公开放映。
未经明确成本确认，不要生成 4k 或使用付费持久存储。

默认值

当请求未指定时，使用以下默认值：

平台：TikTok 和 Instagram Reels
宽高比：9:16
时长：10 秒
分辨率：草稿使用 720p；当用户要求交付质量时使用 1080p
音频：启用 Seedance 原生对话
结构：一个连续手持拍摄，包含四个微节拍
语言：匹配用户或其指定的目标市场
存储：临时输出，本地下载
批次：三个独立的创意变体，而不是一次性的多切生成

保持每个 Seedance 任务在 4 到 15 秒之间。对于 20–30 秒的广告，规划两个或三个独立有效的片段，并仅在每个片段通过 QC 后才进行组装。

工作流程

1. 构建可靠的简要产品介绍

仅收集或推断安全的创意选择：

产品名称、类别、URL 和清晰的产品图像
目标买家、问题、差异化点、优惠和行动号召
基于来源的声明记录和禁止声明
平台、目标市场、语言、时长和批次大小
格式：开箱展示、首次使用演示、直接面对镜头演示、问题解决、试穿或创作者对比
人才来源：用户提供、聘用的创作者或合成通用
已批准的演员图像、产品图像、首帧画面或参考媒体

当提供的产品 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。

每个广告选择一个承诺。优先选择可见的产品动作而非形容词：

打开一个包裹
使用产品一次
展示一个控制项或功能
仅当有真实证据时，比较一个“之前/之后”的状态
提及一个优点和一个行动号召

使用口头钩子，而不是生成的覆层文字。将可选的简短钩子覆层和字幕保留到后期制作。

对于广告批次，每次只变化一个维度：

钩子 A：痛点识别
钩子 B：意外发现
钩子 C：产品优先的视觉展示

保持产品事实、优惠、人才权利和行动号召来源在批次中一致。

3. 为自然语言编写

编写符合目标市场的缩略形式、停顿、自我纠正和简单词汇。避免精心打磨的品牌文案节奏。

使用以下说话预算：

英语：目标约为每秒 2.0–2.8 个单词
中文：目标约为每秒 3.5–5.0 个汉字

使用以下默认节拍图构建一个 10 秒的广告：

0.0–1.5s — 口头或视觉钩子；产品已可见
1.5–4.0s — 打开、涂抹、穿戴或让产品更近
4.0–8.0s — 展示一个来源支持的特性或可见效果
8.0–10.0s — 自然反应和一个行动号召

除非声明记录支持且人才被授权，否则不要使用“我已经用了几个星期”、“这治好了”、“每个人都喜欢”或类似的体验/结果语言。

4. 选择 Seedance 媒体模式

仅使用一种模式：

首帧画面 — 最佳控制。使用已显示批准人才和确切产品的经过验证的 9:16 图像。将其作为 production.first_frame_url 或 production.first_frame_path 传递。
多模参考 — 使用单独的已批准演员和产品图像。将它们放入 production.reference_image_urls 或 production.reference_image_paths。
仅文本 — 仅用于通用概念草稿。警告：产品、包装和人才的保真度会降低。

不要混合首帧/末帧输入与多模参考。保持演员身份、产品几何形状、包装颜色、瓶盖方向、标签位置和已批准的服装稳定。

如果需要先创建主画面，请使用可用的图像编辑技能并参考演员和产品图像，然后在调用 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 参数传递。审查经过编辑的负载并确认：

模型为 seedance-2.0
时长为 4–15
宽高比为 9:16
分辨率符合预期
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 推断成功。

下载后：

使用 ffprobe 检查 MP4；记录时长、尺寸、帧率、编解码器和音频存在情况。
提取开头、演示和最终帧。
检查面部身份、手、嘴、产品几何形状、包装、标签、产品数量和背景连续性。
听取完整音频或进行转录。验证确切语言、可理解性、口型同步、产品声音和完整的行动号召。
拒绝包含虚构文字、剪辑过的语音、面部漂移、变形的双手、产品变异、披露冲突或缺少可见演示的输出。
仅当原始生成通过后，才添加平台字幕、安全区域文字、音乐或行动号召覆盖层。

如果出现任何核心产品或肖像缺陷，请使用更清晰的参考画面重新生成或简化动作。不要通过裁剪来隐藏重大缺陷。

输出协议

以用户的语言返回以下部分：

假设
产品来源和声明记录
选定的 UGC 格式和受众角度
钩子变体
带时间节拍的最终脚本
参考资产计划
可直接使用的 Seedance 提示
验证后的负载或确切的运行命令
合规性和披露说明
QC 结果
工件路径 — 仅在实际文件存在时

对于生成的结果，区分 已创建、仍在处理、失败和已下载。绝不要在没有真实本地文件或已验证的远程结果 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 执行。

HiAPI Seedance 2.0 UGC 广告视频技能