Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Generate AI videos using Volcengine Seedance model. Supports text-to-video (T2V), image-to-video (I2V), and audio-synced video generation. Use this skill when the user wants to create or generate videos.
.claude/skills/freestylefly-seedance/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-13 | ✗→✓ | ▲ Improved | 253% | 0% |
| case-02 | ✗→✓ | ▲ Improved | 139% | 0% |
| case-01 | ✗→✓ | ▲ Improved | 272% | 0% |
| case-03 | ✗→✓ | ▲ Improved | 469% | 0% |
| case-12 | ✗→✓ | ▲ Improved | 66% | 0% |
使用火山引擎 Seedance 模型生成高质量 AI 视频，支持文本生成视频（T2V）、图片生成视频（I2V）、音画同步等多种创作模式。
> ✨ Node.js 版本：此脚本使用 Node.js 实现，无需 Python 环境。通过入口脚本自动检测 Node.js 运行时（优先使用系统 node，回退到 WeSight 内置运行时），Windows 和 Mac 用户都可以开箱即用。
https://ark.cn-beijing.volces.com/api/v3ARK_API_KEY 读取Authorization: Bearer {API_KEY}方式一：通过环境变量配置（推荐）
在终端中设置环境变量：
bash# macOS/Linux export ARK_API_KEY="你的API密钥" # 或者添加到 ~/.zshrc 或 ~/.bashrc 以永久生效 echo 'export ARK_API_KEY="你的API密钥"' >> ~/.zshrc source ~/.zshrc
powershell# Windows PowerShell $env:ARK_API_KEY="你的API密钥" # 或者设置系统环境变量以永久生效 [System.Environment]::SetEnvironmentVariable('ARK_API_KEY', '你的API密钥', 'User')
方式二：通过 WeSight 启动时注入
WeSight 会自动读取系统环境变量，确保在启动 WeSight 前已设置 ARK_API_KEY。
如何获取 API Key：
无需安装任何依赖！ 该脚本已兼容 Node.js 内置模块。
WeSight 已包含 Node.js 运行时，所有必要的依赖已被自动打包。Windows 和 Mac 用户无需额外配置。
Seedance 视频生成是一个异步过程：
task_idsucceededvideo_url 字段下载生成的 MP4 文件所有 Seedance 模型在 default 模式（在线推理）下提供：
注意：文档中未明确说明 200万 token 能生成多少个视频，消耗取决于视频时长、分辨率和是否使用图片/音频。建议先小批量测试。
| 模型系列 | RPM（每分钟请求数） | 并发数 | TPD（离线模式每日token） | |---------|-------------------|--------|----------------------| | Pro 系列 | 600 | 10 | 5000亿 | | Lite 系列 | 300 | 5 | 2500亿 |
⚠️ 重要提醒：
路径说明：下面的示例使用 $SKILLS_ROOT 环境变量来引用脚本路径。WeSight 会自动设置这个变量，指向实际的 SKILLs 目录位置，因此无需手动修改路径。
根据文字描述生成视频，适合创意激发和概念验证。
bashbash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "一只小猫在草地上玩耍，阳光明媚，镜头缓缓推进" \ --duration 5 \ --output generated_video.mp4
示例提示词：
基于首帧图片生成动态视频，支持本地图片和网络URL。
bash# 使用本地图片 bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "女孩睁开眼，温柔地看向镜头，头发被风吹动" \ --image "/Users/yourname/Pictures/girl.jpg" \ --duration 5 \ --output i2v_video.mp4 # 使用网络图片 bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "女孩睁开眼，温柔地看向镜头，头发被风吹动" \ --image "https://example.com/first_frame.jpg" \ --duration 5 \ --output i2v_video.mp4
支持的图片来源：
/path/to/image.jpghttps://example.com/image.jpgfile:///path/to/image.jpg支持的图片格式：
提供首帧和尾帧，生成过渡动画。支持本地图片。
bashbash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "360度环绕运镜，流畅过渡" \ --image "/Users/yourname/Pictures/first_frame.jpg" \ --image "/Users/yourname/Pictures/last_frame.jpg" \ --duration 5 \ --output transition_video.mp4
融合多张参考图的特征生成视频。支持混合使用本地图片和网络图片。
bashbash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗，坐在[图3]的草坪上，视频卡通风格" \ --image "/Users/yourname/Pictures/person.jpg" \ --image "https://example.com/dog.jpg" \ --image "/Users/yourname/Pictures/grass.jpg" \ --model "doubao-seedance-1-0-lite-i2v-250428" \ --duration 5 \ --output multi_ref_video.mp4
生成包含音频的视频（环境音、动作音、背景音乐等）。支持本地图片。
bashbash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "镜头围绕人物推镜头拉近，特写人物面部，她正在用京剧唱腔唱'月移花影，疑是玉人来'，唱词充满情感" \ --image "/Users/yourname/Pictures/actress.jpg" \ --audio \ --duration 5 \ --model "doubao-seedance-1-5-pro-251215" \ --output audio_video.mp4
| 参数 | 说明 | 示例 | |-----|------|------| | --prompt | 视频描述提示词（必需） | "小猫在玩耍" |
| 参数 | 说明 | 默认值 | 可选值 | |-----|------|-------|--------| | --image | 参考图片路径或URL（可多次使用） | 无 | 本地文件路径或URL | | --model | 模型ID | doubao-seedance-1-5-pro-251215 | 见模型列表 | | --duration | 视频时长（秒） | 5 | 2-12（不同模型范围不同） | | --ratio | 宽高比 | adaptive | adaptive, 16:9, 9:16, 1:1 | | --audio | 生成音频（仅1.5 pro支持） | 否 | 标志参数 | | --no-watermark | 不添加水印 | 否 | 标志参数 | | --output | 输出文件路径 | generated_video.mp4 | 文件路径 | | --poll-interval | 状态查询间隔（秒） | 5 | 1-10 | | --timeout | 最大等待时间（秒） | 300 | 60-600 |
选择合适的模型以平衡质量、速度和成本：
doubao-seedance-1-5-pro-251215doubao-seedance-1-0-pro-250528doubao-seedance-1-0-pro-fast-251015doubao-seedance-1-0-lite-t2v-250428doubao-seedance-1-0-lite-i2v-250428doubao-seedance-2-0-260128使用方式（2月24日后）：
bash# 命令行方式 bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "你的提示词" \ --model "doubao-seedance-2-0-260128" \ --duration 5
或在 WeSight 对话中说："用 Seedance 2.0 生成视频..."
推荐使用场景：
根据使用场景选择合适的宽高比：
bash# 横屏视频（适合 YouTube、B站） --ratio "16:9" # 竖屏视频（适合抖音、快手） --ratio "9:16" # 正方形视频（适合 Instagram） --ratio "1:1" # 自适应（根据内容自动选择） --ratio "adaptive"
不同模型支持的时长范围不同：
bash# 短视频（快速生成） --duration 2 # 标准时长 --duration 5 # 长视频（内容更丰富） --duration 10
注意：
生成无水印视频（用于商业用途）：
bash--no-watermark
调整轮询策略以适应不同场景：
bash# 快速查询（适合短视频） --poll-interval 3 --timeout 180 # 标准配置 --poll-interval 5 --timeout 300 # 耐心等待（适合长视频或高峰期） --poll-interval 10 --timeout 600
生成过程中可能出现的任务状态：
| 状态 | 说明 | 操作 | |------|------|------| | queued | 任务排队中 | 继续等待 | | running | 正在生成视频 | 继续等待 | | succeeded | 生成成功 | 下载视频 | | failed | 生成失败 | 查看错误信息 |
错误：未设置环境变量 ARK_API_KEY
错误：任务创建失败 (HTTP 401)
错误：任务创建失败 (HTTP 400)
错误：任务超时
--timeout 值，或稍后重试错误：任务失败
错误：限流 (HTTP 429)
生成的视频具有以下特征：
--audio）[风格]，[场景描述]，[主体动作]，[镜头运动]，[氛围/情绪]示例：
写实风格，海边日落，一只海鸥在空中盘旋，镜头从远处缓缓推进到海鸥特写，宁静祥和的氛围bashbash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "产品展示：智能手表从不同角度旋转展示" \ --ratio "9:16" \ --duration 5
bashbash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "卡通风格，小兔子在森林里蹦蹦跳跳" \ --ratio "16:9" \ --duration 8 \ --model "doubao-seedance-1-0-pro-250528"
bashbash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "美食特写：热气腾腾的拉面，筷子夹起面条" \ --ratio "1:1" \ --duration 3
bashbash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \ --prompt "科普动画：地球自转，太阳光照射地球表面" \ --ratio "16:9" \ --duration 10
如遇到问题，可以：
Other measured skills in the registry, with their headline benchmark lift.