豆包 Seedream — OpenAI 格式
POST
/v1/images/generations调用豆包 Seedream 系列模型生成图像,兼容 OpenAI Images API。
Bearer Token
模型介绍
Seedream 是火山引擎豆包团队推出的图像生成模型,中文理解能力突出,对成语、典故、国风元素的还原度高。
支持模型
| 模型 | 支持尺寸 | 说明 |
|---|---|---|
doubao-seedream-5-0 | 1920x1920 / 2048x2048 / 2560x1440 等 | 主力版本,中文最佳;最小 1920x1920(3686400 像素) |
⚠️ 尺寸下限:Seedream 系列要求图像像素数 ≥ 3686400(即 1920×1920 及以上)。
2048x2048(1048576 像素)等小尺寸会返回 400image size must be at least 3686400 pixels。 建议使用2048x2048(4K 档)以获得最佳效果。
请求参数
Seedream 请求参数
| 参数 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| model | string | 是 | - | 模型名称:doubao-seedream-5-0 |
| prompt | string | 是 | - | 图像描述;中文理解优秀,建议中文场景直接使用中文 |
| n | integer | 否 | 1 | 生成数量 |
| size | string | 否 | 2048x2048 | 尺寸,最小 1920x1920(像素数 ≥ 3686400),常用 2048x2048 / 2560x1440 |
| seed | integer | 否 | 随机 | 种子;相同 prompt+seed+size 可高度复现 |
| response_format | string | 否 | url | 返回格式:url / b64_json |
请求示例
bash
curl -X POST /v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0",
"prompt": "国风水墨山水画,远山含翠,云雾缭绕",
"size": "2048x2048",
"n": 1
}'响应示例
成功响应
json
{
"created": 1735661700,
"data": [
{
"url": "https://cdn.example.com/images/seedream-abc.png"
}
]
}注意事项
- Seedream 对中文 prompt 的理解优于英文,建议中文场景直接使用中文描述。
seed可用于结果复现:相同prompt+seed+size会生成高度相似的图片。b64_json返回时图片以 Base64 嵌入 JSON,适合直接前端展示。- Seedream 不支持
quality/style参数,传入会被忽略。
