UnityClaw 视频（Seedance 2.0）

根据提示词生成 Seedance 2.0 视频，可选提供参考媒体。运行内置的 CLI 工具，验证其结构化输出结果，并将已下载的本地视频文件返回给用户。

智能体工作流

1. 理解镜头需求

提取主体、动作、场景、景别、摄像机运动、构图、光照、视觉风格、节奏、时长、宽高比、参考媒体的作用，以及明确排除的内容。严格保留用户提供的所有事实性信息与原始文字表述。

仅当缺失某项细节会实质性影响生成结果时，才向用户提问；否则应做出克制且符合电影语言规范的选择并继续执行。不得静默添加用户未要求的品牌、标识、人物、对白或敏感属性。

2. 构建具备运动感知能力的提示词

在信息完备的前提下，按以下顺序撰写一条连贯的提示词：

[主体与场景], [主体动作及时间演进],
[景别与构图], [摄像机运动], [光照与色彩],
[视觉风格与节奏], [连续性要求], [明确排除项]

强调随时间发生的变化。优先使用“摄像机缓慢推进产品，同时反光在金属表面移动”这类具象描述，而非“一段电影感产品视频”等模糊表达。确保所描述动作可在选定时长内合理实现，避免在一个短时生成中强行塞入多个互不相关的场景。

对于图生视频（image-to-video），需明确说明哪些元素应当运动、哪些应保持稳定；对于音频参考，需描述运动或剪辑如何响应节拍或情绪；对于视频参考，需指明其控制的是运动、构图、时序还是风格。切勿承诺精确的人物身份、唇形同步、字体样式或帧级连续性。

3. 选择参数设置

优先采用用户显式指定的选项；否则应用以下默认值：

默认使用快速模型 doubao-seedance-2-0-fast-260128、720p 分辨率、adaptive 宽高比和自动时长。若仅为临时预览且明确可弃用，则使用 480p。当质量优先于交付时效时，选用标准模型 doubao-seedance-2-0-260128。不得仅因更长时长可用而主动选择它。

4. 处理参考媒体

支持图像、音频或视频作为本地文件或 HTTP(S) URL 输入。需识别每份参考媒体的具体作用，并在提示词中明确描述该角色。保留用户输入中重复出现的 --attachment 参数顺序。构建新命令时，应使用多次 --attachment 标志，而非以逗号分隔的单个值。

执行前须解析本地路径。不得将用户提供的本地媒体替换为无关的远程内容。不得假定附加媒体即代表获得人物肖像、受版权保护的角色、品牌或音乐的复制授权。

5. 单次执行

使用 --json 和显式的 --output-dir 参数运行 scripts/generate.js。所有源自用户的 shell 参数均需加引号包裹。视频生成可能耗时较长，因此除非调用方有明确理由，否则应保留默认的 30 分钟超时限制。

允许 CLI 执行其预设的临时性重试逻辑。禁止为同一请求并发启动多个生成命令。

6. 验证与交付

解析 JSON 响应。仅当 success 字段为 true，且每个 files 条目均具有存在的本地 localPath 及正值 bytes 时，才视为成功完成。若服务报告成功但视频未能正确下载，CLI 将返回 OUTPUT_VALIDATION_ERROR 错误码。

向用户呈现本地视频文件，并简要说明所选模型、分辨率、宽高比与时长。将 temporaryUrl 视为诊断信息，而非主要交付物。

7. 有意识地迭代

仅当 error.retryable 为 true 时，才重试技术性失败；并严格遵守 CLI 的重试次数上限。对于认证失败、参数无效、参考文件缺失或输出验证失败等情况，必须先定位并修复根本原因，方可重试。

不得因结果主观上不理想而自动消耗另一次生成配额。应先展示当前结果，并依据用户反馈，仅调整相关联的运动、摄像机、构图、节奏或风格指令。对于复杂序列，建议分别生成聚焦于不同镜头的独立片段，而非反复要求单一提示词产出完整剪辑。

授权

通过固定的环境变量 UNITYCLAW_KEY 提供 API 密钥。如需获取密钥，请联系 UnityClaw。运行时安装声明会自动安装 @unityclaw/sdk；若需手动执行，请在包不可用时运行 npm install @unityclaw/sdk。

使用方式

node scripts/generate.js --prompt "日出时分的山脉航拍镜头"
node scripts/generate.js --prompt "插画角色转向镜头，背景保持静止" --attachment ./character.png --ratio 9:16 --duration 6
node scripts/generate.js --prompt "剪辑节奏贴合参考音轨" --attachment ./music.mp3 --model doubao-seedance-2-0-260128 --json --output-dir ./tasks

参数说明

支持的宽高比： adaptive、16:9、9:16、1:1、4:3、3:4、21:9。

输出契约

启用 --json 后，命令将精确输出一个 JSON 对象。成功响应包含字段：success、attempts、taskId、taskFolder、服务端 duration、outputDir、选定的 settings 以及 files。每个经验证的文件条目包含：name、contentType、绝对路径 localPath、bytes，以及可选的 temporaryUrl。

失败响应包含稳定的 error.code、人类可读的 error.message、error.retryable、attempts，以及可用的任务或日志信息。进程在失败时将以非零退出码终止。

资源索引

• 运行 scripts/generate.js 执行 Seedance 2.0 视频生成。
• 运行 node --test scripts/generate.test.mjs 进行本地 CLI 功能验证。