seedance
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.
freestylefly · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add freestylefly/wesight --skill seedance技能说明
name: seedance description: 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. official: true version: 1.0.1
Seedance 视频生成
使用火山引擎 Seedance 模型生成高质量 AI 视频,支持文本生成视频(T2V)、图片生成视频(I2V)、音画同步等多种创作模式。
✨ Node.js 版本:此脚本使用 Node.js 实现,无需 Python 环境。通过入口脚本自动检测 Node.js 运行时(优先使用系统 node,回退到 WeSight 内置运行时),Windows 和 Mac 用户都可以开箱即用。
配置
- Base URL:
https://ark.cn-beijing.volces.com/api/v3 - API Key: 从环境变量
ARK_API_KEY读取 - 认证方式:
Authorization: Bearer {API_KEY} - SDK: 兼容火山方舟 Python SDK
如何配置 API Key
方式一:通过环境变量配置(推荐)
在终端中设置环境变量:
# macOS/Linux
export ARK_API_KEY="你的API密钥"
# 或者添加到 ~/.zshrc 或 ~/.bashrc 以永久生效
echo 'export ARK_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
# Windows PowerShell
$env:ARK_API_KEY="你的API密钥"
# 或者设置系统环境变量以永久生效
[System.Environment]::SetEnvironmentVariable('ARK_API_KEY', '你的API密钥', 'User')
方式二:通过 WeSight 启动时注入
WeSight 会自动读取系统环境变量,确保在启动 WeSight 前已设置 ARK_API_KEY。
如何获取 API Key:
- 访问火山方舟控制台:https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
- 创建新的 API Key
- 复制密钥并设置为环境变量
前置检查
无需安装任何依赖! 该脚本已兼容 Node.js 内置模块。
WeSight 已包含 Node.js 运行时,所有必要的依赖已被自动打包。Windows 和 Mac 用户无需额外配置。
工作流程
Seedance 视频生成是一个异步过程:
- 提交任务 - 调用 API 创建视频生成任务,获得
task_id - 轮询状态 - 每隔几秒查询任务状态,直到状态变为
succeeded - 下载视频 - 从
video_url字段下载生成的 MP4 文件
配额和限制
免费额度
所有 Seedance 模型在 **default 模式(在线推理)**下提供:
- 200万 token 免费额度
- flex 模式(离线推理)无免费额度
注意:文档中未明确说明 200万 token 能生成多少个视频,消耗取决于视频时长、分辨率和是否使用图片/音频。建议先小批量测试。
限流限制
| 模型系列 | RPM(每分钟请求数) | 并发数 | TPD(离线模式每日token) |
|---|---|---|---|
| Pro 系列 | 600 | 10 | 5000亿 |
| Lite 系列 | 300 | 5 | 2500亿 |
- RPM 限流:账号下同模型每分钟允许创建的任务数量上限
- 并发数限制:同一时刻在处理中的任务数量上限
- TPD 限流:flex 模式下一天内对同一模型的总调用 token 上限
视频保存时间
⚠️ 重要提醒:
- 任务数据(包括视频URL)仅保留 24 小时
- 超时后会被自动清除
- 务必及时下载保存生成的视频
使用示例
路径说明:下面的示例使用 $SKILLS_ROOT 环境变量来引用脚本路径。WeSight 会自动设置这个变量,指向实际的 SKILLs 目录位置,因此无需手动修改路径。
1. 文本生成视频(T2V)
根据文字描述生成视频,适合创意激发和概念验证。
bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
--prompt "一只小猫在草地上玩耍,阳光明媚,镜头缓缓推进" \
--duration 5 \
--output generated_video.mp4
示例提示词:
- "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠"
- "一辆地铁轰隆隆驶过,书页飞扬,镜头开始环绕着女孩360度旋转"
- "海边日落,海浪轻拍沙滩,宁静祥和的氛围"
2. 图片生成视频(I2V)- 首帧引导
基于首帧图片生成动态视频,支持本地图片和网络URL。
# 使用本地图片
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.jpg - ✅ 网络URL:
https://example.com/image.jpg - ✅ file://协议:
file:///path/to/image.jpg
支持的图片格式:
- jpg, jpeg, png, gif, webp, bmp, tiff, heic
3. 图片生成视频(I2V)- 首尾帧引导
提供首帧和尾帧,生成过渡动画。支持本地图片。
bash "$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
4. 多参考图生成视频
融合多张参考图的特征生成视频。支持混合使用本地图片和网络图片。
bash "$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
5. 音画同步视频生成(仅 1.5 pro)
生成包含音频的视频(环境音、动作音、背景音乐等)。支持本地图片。
bash "$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 |
模型选择
选择合适的模型以平衡质量、速度和成本:
Seedance 1.5 pro(推荐)
- 模型ID:
doubao-seedance-1-5-pro-251215 - 特点: 音画同生,最高质量
- 支持: 文生视频、图生视频、首尾帧、有声视频
- 输出: 480p-1080p,24fps,4-12秒
- 限流: RPM 600,并发10
Seedance 1.0 pro
- 模型ID:
doubao-seedance-1-0-pro-250528 - 特点: 高质量标准版本
- 支持: 文生视频、图生视频、首尾帧
- 输出: 480p-1080p,24fps,2-12秒
- 限流: RPM 600,并发10
Seedance 1.0 pro fast
- 模型ID:
doubao-seedance-1-0-pro-fast-251015 - 特点: 快速生成,成本更低
- 支持: 文生视频、图生视频
- 输出: 480p-1080p,24fps,2-12秒
- 限流: RPM 600,并发10
Seedance 1.0 lite(轻量版)
- 文生视频:
doubao-seedance-1-0-lite-t2v-250428 - 图生视频:
doubao-seedance-1-0-lite-i2v-250428 - 特点: 更快速度,支持多参考图
- 限流: RPM 300,并发5
Seedance 2.0(即将支持)
- 模型ID:
doubao-seedance-2-0-260128 - 特点: 下一代视频生成模型,质量和性能全面提升
- 可用性: ⏰ 预计 2026年2月24日18点 开放 API 调用
- 当前状态: 仅在 控制台体验中心 可用
使用方式(2月24日后):
# 命令行方式
bash "$SKILLS_ROOT/seedance/scripts/generate-video.sh" \
--prompt "你的提示词" \
--model
阅读完整来源 ↗