Seedance 视频生成

使用 Seedance 2.0/uP 模型，通过 tokease.cn API 生成 AI 视频。

快速开始

1. 获取 API Key

访问 tokease.cn 注册账号，在 API Keys 页面创建你的 Key。

2. 提供 API Key（手动输入）

调用前直接向用户询问 API Key，通过 --api-key 参数传入，无需设置环境变量：

python3 seedance.py create --prompt "一只小猫在阳光下打哈欠" --api-key "你的API-Key" --wait --download ~/Desktop

3. 生成视频

python3 seedance.py create --prompt "一只小猫在阳光下打哈欠" --api-key "你的API-Key" --wait --download ~/Desktop

Python CLI 工具

使用项目中的 seedance.py 命令行工具，支持完整的创建、查询、下载流程。所有命令都需要通过 --api-key 参数传入 API Key。

创建视频任务

# 基础用法：文生视频
python3 seedance.py create --prompt "你的画面描述" --api-key "xxx" --wait --download ~/Desktop

# 指定画幅比例（默认 16:9）
python3 seedance.py create --prompt "竖屏舞蹈视频" --api-key "xxx" --ratio 9:16 --wait --download ~/Desktop

# 指定时长（秒）
python3 seedance.py create --prompt "延时摄影" --api-key "xxx" --duration 8 --wait --download ~/Desktop

# 指定分辨率
python3 seedance.py create --prompt "城市夜景" --api-key "xxx" --resolution 1080p --wait --download ~/Desktop

# 指定随机种子（可复现结果）
python3 seedance.py create --prompt "..." --api-key "xxx" --seed 42 --wait --download ~/Desktop

# 负向提示词（避免出现的内容）
python3 seedance.py create --prompt "晴天草原" --api-key "xxx" --negative-prompt "模糊, 噪点" --wait --download ~/Desktop

查询和管理任务

# 查询任务状态
python3 seedance.py status <TASK_ID> --api-key "xxx"

# 等待任务完成并下载
python3 seedance.py wait <TASK_ID> --api-key "xxx" --download ~/Desktop

# 仅等待（不下载）
python3 seedance.py wait <TASK_ID> --api-key "xxx"

可选参数一览

| 参数 | 类型 | 默认值 | 说明 | |------|------|--------|------| | --prompt | string | 必填 | 视频画面描述 | | --api-key | string | 必填 | tokease.cn 的 API Key | | --model | string | Seedance 2.0/uP | 模型 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.cn/v1/video/generations
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "model": "Seedance 2.0/uP",
  "prompt": "画面描述",
  "ratio": "16:9",
  "duration": 5,
  "resolution": "720p"
}

查询任务

GET https://tokease.cn/v1/videos/{task_id}
Authorization: Bearer <API_KEY>

返回状态：

pending — 排队中
running — 生成中（含 progress 百分比）
completed — 完成（视频 URL 在 output.video_url）
failed — 失败

使用 curl 调用

# 创建任务
curl -s -X POST "https://tokease.cn/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"model": "Seedance 2.0/uP", "prompt": "小猫打哈欠"}'

# 查询状态
curl -s "https://tokease.cn/v1/videos/<TASK_ID>" \
  -H "Authorization: Bearer $API_KEY"

重要提示

必须提供 --api-key 参数，或在调用前向用户询问 API Key。不再使用环境变量。
API Key 从 tokease.cn 注册获取。
视频生成可能需要数分钟，建议使用 --wait 参数自动等待。
视频 URL 有时效性，生成后请及时下载。
如使用 AI 助手（如 WorkBuddy），直接描述想要的画面即可，助手会询问 API Key 后自动调用此技能。

规则

调用前必须向用户询问并获取 API Key，通过 --api-key 参数传入。
默认模型：Seedance 2.0/uP。
轮询间隔：15 秒。
生成完成后立即下载视频。
失败时清晰展示错误信息，提示可能的修复方案。
始终告知用户任务 ID，以便后续查询。