# Seedance

Generate AI videos using Volcengine Seedance model.

- Repository: https://github.com/netease-youdao/LobsterAI (6161 stars)
- Category: Media
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add netease-youdao/LobsterAI --skill seedance -g -a claude-code -y`
Codex: `npx skills add netease-youdao/LobsterAI --skill seedance -g -a codex -y`
Cursor: `npx skills add netease-youdao/LobsterAI --skill seedance -g -a cursor -y`
Gemini CLI: `npx skills add netease-youdao/LobsterAI --skill seedance -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

**方式一：通过环境变量配置（推荐）**

在终端中设置环境变量：

```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')
```

**方式二：通过 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）

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

The rest: https://github.com/netease-youdao/LobsterAI/blob/HEAD/SKILLs/seedance/SKILL.md