Seedance 视频生成

使用火山引擎 Seedance 模型生成高质量 AI 视频，支持文本生成视频（T2V）、图片生成视频（I2V）、音画同步等多种创作模式。

✨ Node.js 版本：此脚本使用 Node.js 实现，无需 Python 环境。通过入口脚本自动检测 Node.js 运行时（优先使用系统 node，回退到 LobsterAI 内置运行时），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')

方式二：通过 LobsterAI 启动时注入

LobsterAI 会自动读取系统环境变量，确保在启动 LobsterAI 前已设置 ARK_API_KEY。

如何获取 API Key：

1. 访问火山方舟控制台：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
2. 创建新的 API Key
3. 复制密钥并设置为环境变量

前置检查

无需安装任何依赖！ 该脚本已兼容 Node.js 内置模块。

LobsterAI 已包含 Node.js 运行时，所有必要的依赖已被自动打包。Windows 和 Mac 用户无需额外配置。

工作流程

Seedance 视频生成是一个异步过程：

1. 提交任务 - 调用 API 创建视频生成任务，获得 task_id
2. 轮询状态 - 每隔几秒查询任务状态，直到状态变为 succeeded
3. 下载视频 - 从 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 环境变量来引用脚本路径。LobsterAI 会自动设置这个变量，指向实际的 SKILLs 目录位置，因此无需手动修改路径。

1. 文本生成视频（T2V）

根据文字描述生成视频，适合创意激发和概念验证。