Seedance Video Generation#

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

Step 0: 前置检查#

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

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

   未设置 → 提示用户在 火山引擎控制台 获取

2. Python CLI 工具：确认 {baseDir}/seedance.py 存在

   • 不存在 → 降级用 curl（见 references/curl-api-reference.md）

Step 1: 需求分类#

用户意图模式跳转"帮我生成一段视频" / 纯文字描述文生视频→ Step 2，Mode text"用这张图生成视频" / 给了一张图图生视频（首帧）→ Step 2，Mode image给了两张图（开头和结尾）首尾帧视频→ Step 2，Mode first-last"参考这几张图" / 给了多张参考图参考图视频→ Step 2，Mode ref"查下之前那个视频任务" / 给了 task ID任务查询→ Step 4

Step 2: 确认参数#

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

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

场景推荐模型理由日常文/图生视频Seedance 1.5 Pro（默认）稳定，支持音频需要最高质量Seedance 2.0多模态，最强效果快速预览/测试Seedance 2.0 Fast生成快，质量略低预算有限1.5 Pro + Draft mode先低成本预览纯文生视频、低成本1.0 Lite T2V最便宜多参考图1.0 Lite I2V支持 1-4 张参考图

1. 默认参数（用户不指定则用默认值）：

   • 分辨率：720p | 比例：16:9（文生）/ adaptive（图生）| 时长：5秒 | 音频：开

Step 3: 执行生成#

所有模式统一用 Python CLI：

bash

# 文生视频
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: 任务管理#

bash

# 查询状态
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 重新生成

边界条件#

情况处理ARK_API_KEY 未设置停止，引导用户获取图片格式不支持支持 jpeg/png/webp/bmp/tiff/gif（1.5 Pro 额外支持 heic）图片尺寸不合规宽高比 0.4-2.5，单边 300-6000px，≤30MB生成失败（API 错误）展示错误信息 + 建议：prompt 含违规词→修改；配额不足→换模型或稍后重试视频 URL 过期24 小时过期！生成后立即下载。过期 → 用 task ID 查询是否还能重新获取任务历史过期7 天后无法查询seedance.py 不存在降级用 curl，见 references/curl-api-reference.md网络超时重试 1 次，仍失败 → 建议用 flex tier（离线队列，便宜 50%）

参数速查#

参数默认值可选值ratio16:9 / adaptive16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveduration54-12 秒（1.5 Pro），2-12（其他）resolution720p480p, 720p, 1080pgenerate_audiotruetrue/false（仅 1.5 Pro）draftfalsetrue/false（仅 1.5 Pro）service_tierdefaultdefault（在线）, flex（离线，半价）

模型 ID 速查#

模型IDSeedance 2.0doubao-seedance-2-0-260128Seedance 2.0 Fastdoubao-seedance-2-0-fast-260128Seedance 1.5 Prodoubao-seedance-1-5-pro-251215Seedance 1.0 Prodoubao-seedance-1-0-pro-250528Seedance 1.0 Pro Fastdoubao-seedance-1-0-pro-fast-251015Seedance 1.0 Lite T2Vdoubao-seedance-1-0-lite-t2v-250428Seedance 1.0 Lite I2Vdoubao-seedance-1-0-lite-i2v-250428