- name
- volcengine-doubao-image-gen
- description
- 豆包图像与视频生成。使用火山引擎 API 生成图片或短视频，支持 Seedream 文生图/图生图/组图，以及 Seedance 文生视频。触发词：豆包图片、doubao、生成图片、火山引擎、字节跳动图片生成、豆包视频、Seedance、生成视频。
豆包图像与视频生成
使用火山引擎豆包 API 生成图片与短视频。
- 默认图片模型：
doubao-seedream-5-0-260128 - 默认视频模型：
doubao-seedance-1-5-pro-251215
环境要求
必需凭证
ARK_API_KEY：火山引擎豆包 API Key（必填）
可选环境变量
DOUBAO_MODEL：覆盖默认图片模型版本（可选）DOUBAO_VIDEO_MODEL：覆盖默认视频模型版本（可选）
快速开始
# 设置 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）
python3 scripts/generate_image.py \
--prompt "星空下的城市夜景，赛博朋克风格" \
--filename "city.png"指定 Seedream 5.0
python3 scripts/generate_image.py \
--prompt "未来感产品海报，极简高级，金属质感" \
--model doubao-seedream-5-0-260128 \
--filename "seedream5.png"图生图
python3 scripts/generate_image.py \
--prompt "参考这个 LOGO，做一套户外运动品牌视觉设计，品牌名称为 GREEN" \
--image "https://example.com/logo.png" \
--sequential auto \
--max-images 5 \
--filename "brand_"多图参考
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 |
生成一个简单视频
python3 scripts/generate_video.py \
--prompt "一只红色小龙虾在白色桌面上缓慢挥动钳子，极简插画风格，镜头稳定" \
--duration 5 \
--resolution 720p \
--ratio 16:9 \
--filename "seedance-demo.mp4"API Key 获取
- 访问火山引擎控制台：https://console.volcengine.com/ark
- 创建或选择一个接入点
- 获取 API Key
提示词技巧
建议按以下结构编写：
- 主体描述（是什么）
- 场景/环境（在哪里）
- 风格（赛博朋克、水彩、油画等）
- 光影效果
- 氛围/情绪
注意事项
- 图片尺寸越大，生成时间越长
- 默认添加水印，使用
--no-watermark可去除 - 组图使用
--sequential auto和--max-images - 图生图可通过多次
--image传入多张参考图 - 输出文件名现在会自动做安全清洗，避免提示词里的
/等字符造成异常路径 - 图片下载链接会做基础校验：要求
https且响应内容必须是图片 - 视频下载链接也会做基础校验：要求
https且响应内容必须是视频 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-260128 | Seedream 5.0，文生图/图生图，适合默认图片调用 | 当前默认图片模型 |
doubao-seedream-4-5-251128 | Seedream 4.5，文生图/图生图，兼容旧工作流 | 兼容保留 |
doubao-seedance-1-5-pro-251215 | Seedance 1.5 Pro，文生视频，走 content generation tasks 接口 | 当前默认视频模型 |