seedance-video

name	seedance-video
description	基于字节 Seedance 模型的视频生成技能，支持文生视频（Text-to-Video）和图生视频（Image-to-Video），可生成高质量短视频。
metadata	{"openclaw":{"emoji":"🎬","os":["darwin","linux","windows"],"primaryEnv":"ARK_API_KEY","requires":{"env":["ARK_API_KEY"],"bins":["python3"]},"install":[{"id":"pip-volcengine","kind":"command","command":"pip install 'volcengine-python-sdk[ark]'","label":"安装火山引擎 Python SDK"}]}}

Seedance Video - 视频生成技能

基于字节跳动 Seedance 模型，支持文生视频和图生视频。

前置条件

1. 需要火山引擎 API Key，设置环境变量 ARK_API_KEY
2. 安装 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：动作/运镜描述（可选，增强效果）
• 其余参数同文生视频

输出规范

1. 视频生成是异步任务，脚本会自动轮询直到完成
2. 成功后将视频下载到指定 --output 路径
3. 向用户展示生成的视频文件路径，并提供预览
4. 如果生成失败，显示错误信息并建议用户调整提示词

提示词优化建议

生成高质量视频的提示词模板：主体 + 场景 + 动作 + 运镜 + 风格 + 画质

示例：「写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠」

进阶资料

当需要更细的广告/叙事提示词范式时，读取 references/prompt-recipes.md。