Seedance 视频生成
使用 Seedance 2.0 模型，通过 tokease.com API 生成 AI 视频。
快速开始
1. 获取 API Key
访问 tokease.com 注册账号，在 API Keys 页面创建你的 Key。
2. 设置环境变量
export SEEDANCE_API_KEY="你的API-Key"
3. 生成视频
python3 seedance.py create --prompt "一只小猫在阳光下打哈欠" --wait --download ~/Desktop
Python CLI 工具
使用项目中的 seedance.py 命令行工具，支持完整的创建、查询、下载流程。
创建视频任务
# 基础用法：文生视频
python3 seedance.py create --prompt "你的画面描述" --wait --download ~/Desktop
# 指定画幅比例（默认 16:9）
python3 seedance.py create --prompt "竖屏舞蹈视频" --ratio 9:16 --wait --download ~/Desktop
# 指定时长（秒）
python3 seedance.py create --prompt "延时摄影" --duration 8 --wait --download ~/Desktop
# 指定分辨率
python3 seedance.py create --prompt "城市夜景" --resolution 1080p --wait --download ~/Desktop
# 指定随机种子（可复现结果）
python3 seedance.py create --prompt "..." --seed 42 --wait --download ~/Desktop
# 负向提示词（避免出现的内容）
python3 seedance.py create --prompt "晴天草原" --negative-prompt "模糊, 噪点" --wait --download ~/Desktop
查询和管理任务
# 查询任务状态
python3 seedance.py status <TASK_ID>
# 等待任务完成并下载
python3 seedance.py wait <TASK_ID> --download ~/Desktop
# 仅等待（不下载）
python3 seedance.py wait <TASK_ID>
可选参数一览
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
--prompt |
string | 必填 | 视频画面描述 |
--model |
string | Seedance 2.0/u3 |
模型 ID |
--ratio |
string | - | 画幅：16:9, 4:3, 1:1, 3:4, 9:16, 21:9 |
--duration |
int | - | 视频时长（秒） |
--resolution |
string | - | 分辨率：480p, 720p, 1080p |
--seed |
int | - | 随机种子，-1 为随机 |
--negative-prompt |
string | - | 负向提示词，描述不想出现的画面 |
--wait |
flag | - | 创建后自动等待任务完成 |
--download |
path | - | 下载目录，如 ~/Desktop |
--interval |
int | 15 |
轮询间隔（秒） |
API 格式说明
创建任务
POST https://tokease.com/v1/videos/generations
Authorization: Bearer <SEEDANCE_API_KEY>
Content-Type: application/json
{
"model": "Seedance 2.0/u3",
"prompt": "画面描述",
"ratio": "16:9",
"duration": 5,
"resolution": "720p"
}
查询任务
GET https://tokease.com/v1/videos/{task_id}
Authorization: Bearer <SEEDANCE_API_KEY>
返回状态：
- pending — 排队中
- running — 生成中（含 progress 百分比）
- completed — 完成（视频 URL 在 output.video_url）
- failed — 失败
使用 curl 调用
# 创建任务
curl -s -X POST "https://tokease.com/v1/videos/generations" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $SEEDANCE_API_KEY" \
-d '{"model": "Seedance 2.0/u3", "prompt": "小猫打哈欠"}'
# 查询状态
curl -s "https://tokease.com/v1/videos/<TASK_ID>" \
-H "Authorization: Bearer $SEEDANCE_API_KEY"
重要提示
- 必须设置
SEEDANCE_API_KEY环境变量，否则无法调用 API。 - API Key 从 tokease.com 注册获取。
- 视频生成可能需要数分钟，建议使用
--wait参数自动等待。 - 视频 URL 有时效性，生成后请及时下载。
- 如使用 AI 助手（如 WorkBuddy），直接描述想要的画面即可，助手会自动调用此技能。
规则
- 调用 API 前必须检查
SEEDANCE_API_KEY是否已设置。 - 默认模型：
Seedance 2.0/u3。 - 轮询间隔：15 秒。
- 生成完成后立即下载视频。
- 失败时清晰展示错误信息，提示可能的修复方案。
- 始终告知用户任务 ID，以便后续查询。
