豆包 Seedance 视频生成
使用随技能打包的脚本，通过字节跳动 Seedance 视频模型在火山引擎 Ark 上生成/编辑视频：
- 豆包 Seedance 系列视频模型（通过 Ark contents/generations/tasks 接口）
- 支持文生视频、图生视频（单图 / 多图参考）
默认设置：
- 默认模型：
doubao-seedance-1-5-pro-251215（可用--model覆盖） - 默认时长：
5秒 - 默认比例：
16:9
文生视频
uv run {baseDir}/scripts/generate_video.py \
--prompt "一个在草地上奔跑的小狗视频，阳光明媚，电影感" \
--filename "奔跑小狗.mp4"使用 YAML 配置文件
可以将所有生视频参数写入 YAML 配置文件，然后通过 --config 参数使用：
文生视频配置示例 (text2video.yaml)：
prompt: 一个在草地上奔跑的小狗视频，阳光明媚，电影感
filename: 奔跑小狗.mp4
ratio: 16:9
duration: 5图生视频配置示例（带 URL 参考图列表，image2video.yaml）：
prompt: 将图1的表情换为图2的表情，做一个眨眼微笑的短视频
filename: 表情女孩.mp4
images:
- https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png
- https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png
ratio: 9:16
duration: 5本地参考图配置示例（local_images.yaml）：
prompt: 多图融合成一个动画短片
filename: 多图融合动画.mp4
images:
- /path/to/参考图1.jpg
- /path/to/参考图2.png
ratio: 16:9
duration: 8使用方法：
uv run {baseDir}/scripts/generate_video.py --config image2video.yaml混合使用配置文件和命令行参数（命令行参数优先级更高）：
uv run {baseDir}/scripts/generate_video.py --config prompt.yaml --filename "自定义文件名.mp4"YAML 配置文件支持的所有参数：
prompt: 视频内容描述filename: 输出文件名images: 参考图像列表（可以是 URL 或本地文件路径）ratio: 画面比例（如 "16:9"、"9:16"）duration: 视频时长（秒）model: 完整的模型名称（高级选项）api_key: API 密钥
图生视频 / 参考图（URL 或本地文件均可，多图，使用 lite i2v 模型）
uv run {baseDir}/scripts/generate_video.py \
--prompt "参考图片中的女孩，做一个挥手微笑的短视频" \
--filename "挥手女孩.mp4" \
-i "https://example.com/ref_image_1.png" \
-i "/path/to/local_ref_2.jpg" \
--ratio "9:16" \
--duration 8只用参考图（无显式文案提示）
uv run {baseDir}/scripts/generate_video.py \
--filename "仅参考图生成视频.mp4" \
-i "/path/to/ref1.jpg" \
-i "/path/to/ref2.png"提示：至少需要「提示词」或「参考图」其一存在，否则脚本会报错。
注意事项
API 密钥
- 需要设置
ARK_API_KEY环境变量
参数说明
- prompt：视频内容文案（中文 / 英文均可）
- image / -i：
- URL：直接透传给 Ark（例如公网可访问的图片链接） - 本地文件：自动读取并转成 data:image/...;base64,... 形式再发送 - 可多次传入，形成多图参考（多图目前仅在 doubao-seedance-1-0-lite-i2v-250428 等 lite i2v 模型下生效）
- ratio：画面比例，常用：
- "16:9"（默认） - "9:16" - "1:1" - "21:9"
- duration：视频时长（秒），由模型 / Endpoint 实际支持的区间决定
- model（可选，高级）：直接指定 Ark Endpoint / 模型 ID，覆盖默认绑定
轮询脚本 get_video_task_status.py 额外参数：
- interval：轮询间隔（秒），默认
10，可根据任务耗时与频率需求自行调整 - timeout：最大等待时间（秒），默认
600，超过后脚本会报错退出
结果与文件输出
- Ark 视频生成通常是异步任务：
- 脚本会调用 POST /contents/generations/tasks - 成功时优先解析返回的 id / task_id 作为任务 ID - 如果响应体中直接携带 video_url，脚本会尝试拉取并将视频保存到本地
- 保存路径规则：
- 若 --filename 未指定目录，则默认保存到本仓库下的 outputs/ 目录 - 若文件名无后缀，则默认补上 .mp4
若调用成功但后端仅返回任务 ID、尚未生成 video_url，脚本会输出任务 ID，可配合轮询脚本一起使用：
# 1) 先创建任务（可能只返回 TASK_ID）
uv run {baseDir}/scripts/generate_video.py \
--prompt "一个示例视频" \
--filename "示例视频.mp4"
# 2) 拿到上一步输出的 TASK_ID 后，轮询直到生成完成并下载视频
uv run {baseDir}/scripts/get_video_task_status.py \
cgt-20260226184301-4h8v6 \
--filename "示例视频.mp4" \
--interval 5轮询脚本会：
- 定期调用
GET /contents/generations/tasks/{task_id}查看任务状态 - 当状态为
succeeded/completed且拿到video_url时，自动下载视频到本地
文件名推荐（供调用方参考）
- 不要在文件名里包含具体实现细节（如 "seedance"、"ark" 等）
- 文件名语言建议与 Prompt 语言一致，如中文 Prompt 就用简短中文文件名（如
挥手女孩.mp4） - 文件名要有语义但尽量简短，避免过长句子
关键词提示（便于发现 / 搜索命中）
- "doubao", "豆包", "Seedance"
- "ByteDance video model", "字节跳动视频生成"
- "文生视频", "图生视频", "视频生成", "短视频生成"