Seedance 2.5 视频生成（tokease.cn）

使用 doubao-seedance-2-5 模型，通过 tokease.cn API 生成 AI 视频。Seedance 2.5 原生支持音频生成，视频画面与环境音效由模型一体化产出，无需额外配置音频参数。支持文生视频（text-to-video）和图生视频（image-to-video）两种模式。

API Key 获取与使用

首次使用

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

第一次使用时，必须向用户询问 API Key。 向用户展示如下提示：

> 使用此功能需要 tokease.cn 的 API Key。
> 请前往 https://tokease.cn 注册并获取 API Key，然后将 Key 发送给我。
> 我会在本次会话中使用它来调用视频生成接口。

获取到 API Key 后，通过 --api-key 参数传入脚本。不使用环境变量，不写入任何文件。

后续调用

同一会话中获取过 API Key 后，后续调用复用同一 Key 即可，无需再次询问。

Python CLI 工具

使用 scripts/seedance.py 命令行工具，支持完整的创建、查询、下载流程。脚本路径相对于技能目录为 scripts/seedance.py。

执行时使用完整路径，例如：

/Users/qiqiouou/.workbuddy/binaries/python/versions/3.13.12/bin/python3 <技能目录>/scripts/seedance.py create --prompt "描述" --api-key "xxx" --wait --download ~/Desktop

文生视频

# 基础用法
python3 seedance.py create --prompt "一只小猫在阳光下打哈欠" --api-key "xxx" --wait --download ~/Desktop

# 竖屏短视频
python3 seedance.py create --prompt "城市夜景延时摄影" --api-key "xxx" --ratio 9:16 --resolution 1080p --wait --download ~/Desktop

# 指定时长和帧率
python3 seedance.py create --prompt "海浪拍打沙滩" --api-key "xxx" --duration 8 --fps 30 --wait --download ~/Desktop

# 负向提示词
python3 seedance.py create --prompt "晴天草原" --api-key "xxx" --negative-prompt "模糊, 噪点" --wait --download ~/Desktop

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

# 镜头运动控制
python3 seedance.py create --prompt "穿越森林" --api-key "xxx" --camera zoom_in --wait --download ~/Desktop

图生视频

# 首帧图生视频（提供图片 URL）
python3 seedance.py create --prompt "让画面动起来" --api-key "xxx" --first-frame-image "https://example.com/image.jpg" --wait --download ~/Desktop

# 首帧 + 尾帧（起止帧插值）
python3 seedance.py create --prompt "平滑过渡" --api-key "xxx" --first-frame-image "https://example.com/start.jpg" --last-frame-image "https://example.com/end.jpg" --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"

参数一览

API 格式说明

创建任务

POST https://tokease.cn/v1/video/generations
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "model": "doubao-seedance-2-5",
  "prompt": "画面描述",
  "width": 1280,
  "height": 720,
  "duration": 5,
  "fps": 30,
  "seed": 42,
  "first_frame_image": "https://example.com/image.jpg",
  "metadata": {
    "negative_prompt": "模糊, 噪点",
    "camera": "zoom_in"
  }
}

参数说明：
- ratio + resolution 会在脚本内自动转换为 width + height 像素值
- negative_prompt 和 camera 会被放入 metadata 对象中传递
- first_frame_image / last_frame_image 用于图生视频模式
- 不包含任何音频参数——Seedance 2.5 原生生成音频

查询任务

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": "doubao-seedance-2-5", "prompt": "小猫打哈欠"}'

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

规则

1. 首次使用必须向用户询问 API Key，通过 --api-key 参数传入。不使用环境变量，不写入文件。
2. 同一会话内获取过 API Key 后，后续调用复用同一 Key，无需重复询问。
3. 默认模型：doubao-seedance-2-5。
4. 轮询间隔：15 秒。
5. 生成完成后立即下载视频到用户指定目录（默认 ~/Desktop）。
6. 失败时清晰展示错误信息，提示可能的修复方案。
7. 始终告知用户任务 ID，以便后续查询。
8. 不配置任何音频参数，依赖 Seedance 2.5 原生音频生成能力，生成的视频自带音轨。
9. 如果用户提供了图片 URL，使用图生视频模式（--first-frame-image）。
10. 如果用户未指定画幅和分辨率，不传该参数，由 API 使用默认值。