Seedance Video Generation

使用字节跳动 Seedance 模型通过火山引擎 Ark API 生成 AI 视频。

Step 0: 前置检查

1. API Key：确认 ARK_API_KEY 环境变量已设置

   echo $ARK_API_KEY | head -c 8  # 只显示前 8 位确认存在
   

   未设置 → 提示用户在 火山引擎控制台 获取
2. Python CLI 工具：确认 {baseDir}/seedance.py 存在
   • 不存在 → 降级用 curl（见 references/curl-api-reference.md）

Step 1: 需求分类

Step 2: 确认参数

必须在调 API 前跟用户确认以下内容：

1. Prompt：向用户展示将使用的 prompt，确认后再提交
2. 模型选择（根据场景推荐）：

3. 默认参数（用户不指定则用默认值）：
   • 分辨率：720p | 比例：16:9（文生）/ adaptive（图生）| 时长：5秒 | 音频：开

Step 3: 执行生成

所有模式统一用 Python CLI：

# 文生视频
python3 {baseDir}/seedance.py create \
  --prompt "描述文字" \
  --ratio 16:9 --duration 5 --resolution 720p \
  --wait --download ~/Desktop

# 图生视频（首帧）
python3 {baseDir}/seedance.py create \
  --prompt "动作描述" --image /path/to/photo.jpg \
  --wait --download ~/Desktop

# 首尾帧
python3 {baseDir}/seedance.py create \
  --prompt "过渡描述" --image first.jpg --last-frame last.jpg \
  --wait --download ~/Desktop

# 参考图（1-4张，Lite I2V）
python3 {baseDir}/seedance.py create \
  --prompt "[图1]的人物在跳舞" --ref-images ref1.jpg ref2.jpg \
  --model doubao-seedance-1-0-lite-i2v-250428 \
  --wait --download ~/Desktop

# Draft 模式（便宜预览）
python3 {baseDir}/seedance.py create \
  --prompt "描述" --draft true --wait --download ~/Desktop

# 从 Draft 生成正式版
python3 {baseDir}/seedance.py create \
  --draft-task-id <DRAFT_TASK_ID> --resolution 720p \
  --wait --download ~/Desktop

--wait --download 会自动轮询等待 + 下载，无需手动轮询。

超时保护

• --wait 默认超时 10 分钟
• 超时后展示 task ID 给用户，可后续用 status 查询
• 正常生成时间：文生 1-3 分钟，图生 2-5 分钟

Step 4: 任务管理

# 查询状态
python3 {baseDir}/seedance.py status <TASK_ID>

# 等待并下载已有任务
python3 {baseDir}/seedance.py wait <TASK_ID> --download ~/Desktop

# 列出任务
python3 {baseDir}/seedance.py list --status succeeded

# 取消/删除
python3 {baseDir}/seedance.py delete <TASK_ID>

Step 5: 验证与交付

1. 确认视频文件已下载：ls -lh ~/Desktop/seedance_video_*.mp4
2. 用 MEDIA:<path> 发送视频给用户
3. 展示 task ID：方便用户后续查询或重新下载
4. 询问是否满意，不满意 → 调整 prompt 重新生成

边界条件

参数速查

模型 ID 速查