豆包图像与视频生成#

使用火山引擎豆包 API 生成图片与短视频。

• 默认图片模型： doubao-seedream-5-0-260128
• 默认视频模型： doubao-seedance-1-5-pro-251215

环境要求#

必需凭证#

• ARK_API_KEY：火山引擎豆包 API Key（必填）

可选环境变量#

• DOUBAO_MODEL：覆盖默认图片模型版本（可选）
• DOUBAO_VIDEO_MODEL：覆盖默认视频模型版本（可选）

快速开始#

bash

# 设置 API Key
export ARK_API_KEY="your-api-key"

# 文生图
python3 scripts/generate_image.py --prompt "一只可爱的猫咪" --filename "cat.png"

图片脚本参数说明#

参数说明默认值--prompt / -p图片描述（必填）---filename / -f输出文件名自动生成--size / -s图片尺寸 (1K/2K/4K)2K--no-watermark不添加水印默认有水印--model / -m图片模型名称doubao-seedream-5-0-260128--image / -i参考图 URL（可多次，图生图）无--sequential是否生成组图 ( disabled/ auto)disabled--max-images组图最大数量无限制--stream流式输出false

安全提示：不要通过命令行传递 API Key，请使用环境变量 ARK_API_KEY。

使用示例#

文生图（默认走 Seedream 5.0）#

bash

python3 scripts/generate_image.py \
  --prompt "星空下的城市夜景，赛博朋克风格" \
  --filename "city.png"

指定 Seedream 5.0#

bash

python3 scripts/generate_image.py \
  --prompt "未来感产品海报，极简高级，金属质感" \
  --model doubao-seedream-5-0-260128 \
  --filename "seedream5.png"

图生图#

bash

python3 scripts/generate_image.py \
  --prompt "参考这个 LOGO，做一套户外运动品牌视觉设计，品牌名称为 GREEN" \
  --image "https://example.com/logo.png" \
  --sequential auto \
  --max-images 5 \
  --filename "brand_"

多图参考#

bash

python3 scripts/generate_image.py \
  --prompt "将图 1 的服装换为图 2 的服装" \
  --image "https://example.com/look1.png" \
  --image "https://example.com/look2.png" \
  --filename "outfit_swap.png"

视频生成#

使用 scripts/generate_video.py 调用 Seedance 视频生成接口。

视频脚本参数说明#

参数说明默认值--prompt / -p视频描述（必填）---filename / -f输出视频文件名自动生成--model / -m视频模型名称doubao-seedance-1-5-pro-251215--duration视频时长（秒）5--resolution分辨率720p--ratio画幅比例16:9--camera-fixed固定机位false--no-audio不生成音频false--watermark添加水印false--poll-interval轮询间隔秒数5--timeout最大等待秒数300

生成一个简单视频#

bash

python3 scripts/generate_video.py \
  --prompt "一只红色小龙虾在白色桌面上缓慢挥动钳子，极简插画风格，镜头稳定" \
  --duration 5 \
  --resolution 720p \
  --ratio 16:9 \
  --filename "seedance-demo.mp4"

API Key 获取#

1. 访问火山引擎控制台： https://console.volcengine.com/ark
2. 创建或选择一个接入点
3. 获取 API Key

提示词技巧#

建议按以下结构编写：

1. 主体描述（是什么）
2. 场景/环境（在哪里）
3. 风格（赛博朋克、水彩、油画等）
4. 光影效果
5. 氛围/情绪

注意事项#

1. 图片尺寸越大，生成时间越长
2. 默认添加水印，使用 --no-watermark 可去除
3. 组图使用 --sequential auto 和 --max-images
4. 图生图可通过多次 --image 传入多张参考图
5. 输出文件名现在会自动做安全清洗，避免提示词里的 / 等字符造成异常路径
6. 图片下载链接会做基础校验：要求 https 且响应内容必须是图片
7. 视频下载链接也会做基础校验：要求 https 且响应内容必须是视频
8. Seedance 不走图片接口，需使用 generate_video.py

故障排查#

错误：No API key provided

• 设置环境变量： export ARK_API_KEY="your-key"

错误：API Error 401

• API Key 无效或过期

错误：API Error 429

• 请求频率超限，稍后重试

错误：Network Error

• 检查网络连接或代理设置

模型版本#

模型说明状态doubao-seedream-5-0-260128Seedream 5.0，文生图/图生图，适合默认图片调用当前默认图片模型doubao-seedream-4-5-251128Seedream 4.5，文生图/图生图，兼容旧工作流兼容保留doubao-seedance-1-5-pro-251215Seedance 1.5 Pro，文生视频，走 content generation tasks 接口当前默认视频模型