doubao-image - 豆包图片生成
使用火山引擎豆包模型生成图片。
简介
通过火山引擎豆包图片生成 API 创建图片。支持多模型自动切换、URL 输出等功能。
环境变量
| 变量名 | 必填 | 说明 |
|---|---|---|
VOLCENGINE_IMAGE_API_KEY | Yes | 豆包 API Key |
DOUBAO_IMAGE_OUTPUT_DIR | No | 图片输出目录（默认：workspace/downloads/images） |
Get API Key:
- Login https://console.volces.com/
- Go to API Key management
- Copy your API Key
使用方式
生图：一只可爱的小猫
命令行参数
| 参数 | 说明 | 默认值 |
|---|---|---|
| prompt | 图片描述 | (必填) |
| --model | 使用的模型 | doubao-seedream-4-0-250828 |
| --size | 图片尺寸 | 1024x1024 |
| --num | 生成数量 | 1 |
| --url-only | 仅返回 URL，不下载 | false |
支持的模型（自动切换）
按优先级排序，优先使用第一个，失败则自动尝试下一个：
doubao-seedream-4-0-250828(默认)doubao-seedream-4-5-251128doubao-seedream-5-0-260128doubao-seedream-3-0-t2i-250415
支持的尺寸
- 1024x1024 (默认)
- 1280x720
- 720x1280
- 1024x768
- 768x1024
输出格式
控制台输出
==================================================
Prompt: a cute kitten
Size: 1024x1024
Num: 1
==================================================
Trying model: doubao-seedream-4-0-250828
[OK] Model doubao-seedream-4-0-250828 success
==================================================
Success!
Model: doubao-seedream-4-0-250828
URL: https://...
==================================================
Downloading to: C:\Users\zcf\.openclaw\workspace\downloads\images\doubao_1234567890.jpeg
[OK] Saved: C:\Users\zcf\.openclaw\workspace\downloads\images\doubao_1234567890.jpeg
Size: 256.5 KB
[FILE_PATH] C:\Users\zcf\.openclaw\workspace\downloads\images\doubao_1234567890.jpeg
特殊标记
[URL_ONLY] <url>- 仅生成 URL 时的输出[FILE_PATH] <path>- 文件保存路径
输出目录
图片自动保存到 downloads/images/ 目录。
可通过环境变量自定义：
# Windows
set DOUBAO_IMAGE_OUTPUT_DIR=D:\my_images
# Linux/Mac
export DOUBAO_IMAGE_OUTPUT_DIR=/path/to/images
重要说明
- API Key: 从
VOLCENGINE_IMAGE_API_KEY环境变量读取 - Multi-model fallback: 如果默认模型失败，会自动尝试备选模型
- URL Output: 生成后立即输出图片 URL
错误处理
- 如果所有模型都失败，会显示具体错误信息
- 如果下载失败，仍会输出 URL 供手动下载