| name | seedance-video |
| description | 基于字节 Seedance 模型的视频生成技能，支持文生视频（Text-to-Video）和图生视频（Image-to-Video），可生成高质量短视频。 |
| metadata | {"openclaw":{"emoji":"🎬","os":["darwin","linux","windows"],"primaryEnv":"ARK_API_KEY","requires":{"env":"[Truncated]","bins":"[Truncated]"},"install":["[Truncated]"]}} |
Seedance Video - 视频生成技能
基于字节跳动 Seedance 模型，支持文生视频和图生视频。
前置条件
- 需要火山引擎 API Key，设置环境变量
ARK_API_KEY
- 安装 SDK：
pip install 'volcengine-python-sdk[ark]'
使用方法
文生视频（Text-to-Video）
当用户提供文字描述要求生成视频时，执行 {baseDir}/scripts/text_to_video.py：
python3 {baseDir}/scripts/text_to_video.py \
--prompt "用户的视频描述" \
--ratio "16:9" \
--duration 5 \
--output "{workDir}/output_video.mp4"
参数说明：
--prompt：视频描述文本（必填）--ratio：视频比例，可选 16:9、9:16、1:1（默认 16:9）--duration：视频时长秒数，可选 5 或 10（默认 5）--output：输出文件路径（必填）--model：模型 ID（默认 doubao-seedance-1-5-pro-251215）--seed：随机种子（可选，用于复现）
图生视频（Image-to-Video）
当用户提供图片要求生成视频时，执行 {baseDir}/scripts/image_to_video.py：
python3 {baseDir}/scripts/image_to_video.py \
--image "/path/to/image.jpg" \
--prompt "视频动作描述" \
--ratio "16:9" \
--duration 5 \
--output "{workDir}/output_video.mp4"
参数说明：
--image：输入图片路径（必填）--prompt：动作/运镜描述（可选，增强效果）- 其余参数同文生视频
输出规范
- 视频生成是异步任务，脚本会自动轮询直到完成
- 成功后将视频下载到指定
--output 路径
- 向用户展示生成的视频文件路径，并提供预览
- 如果生成失败，显示错误信息并建议用户调整提示词
提示词优化建议
生成高质量视频的提示词模板：主体 + 场景 + 动作 + 运镜 + 风格 + 画质
示例：「写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠」
进阶资料
当需要更细的广告/叙事提示词范式时，读取 references/prompt-recipes.md。
