豆包 Doubao 图片生成接口 - QuickRouter API 中转接口
▼
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
概述
给定提示和/或输入图像，模型将生成新图像。 相关指南：图像生成 根据提示创建图像。
请求参数
Header 参数
Authorization
string
可选
示例: Bearer {{YOUR_API_KEY}}
Body 参数 application/json
model
string
必需
支持：文生图 doubao-seedream-3-0-t2i-250415 支持：图片编辑 doubao-seededit-3-0-i2i-250628 支持：文生图、图生图 doubao-seedream-5-0-260128 doubao-seedream-4-5-251128 doubao-seedream-4-0-250828
prompt
string
必需
用于生成图像的提示词。
image
可选
输入的图片信息，支持 URL 或 Base64 编码。 图片URL：请确保图片URL可被访问。 Base64编码：请遵循此格式data:image/<图片格式>;base64,<Base64编码>。注意 <图片格式> 需小写，如 data:image/png;base64,<base64_image>。 Any of: 单图 多图
string
可选
doubao-seededit-3.0-i2i 仅支持单图输入。 doubao-seedream-5.0-lite/4.5/4.0 支持单图。
size
可选
Any of: seedream-5.0 seedream-4.5 seedream-4.0 seedream-3.0-t2i seededit-3.0-i2i
string
可选
指定生成图像的尺寸信息，支持以下两种方式，不可混用。 方式 1 | 指定生成图像的分辨率，并在prompt中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。 可选值：2K、3K 方式 2 | 指定生成图像的宽高像素值： 默认值：2048x2048 总像素取值范围：[2560x1440=3686400, 3072x3072x1.1025=10404496] 宽高比取值范围：[1/16, 16] 推荐的宽高像素值： 分辨率 宽高比 宽高像素值 2K 1:1 2048×2048 2K 4:3 2304×1728 2K 3:4 1728×2304 2K 16:9 2848×1600 2K 9:16 1600×2848 2K 3:2 2496×1664 2K 2:3 1664×2496 2K 21:9 3136×1344 3K 1:1 3072×3072 3K 4:3 3456×2592 3K 3:4 2592×3456 3K 16:9 4096×2304 3K 9:16 2304×4096 3K 2:3 2496×3744 3K 3:2 3744×2496 3K 21:9 4704×2016
seed
integer
可选
仅 doubao-seedream-3.0-t2i/seededit-3.0-i2i 支持该参 随机数种子，用于控制模型生成内容的随机性。取值范围为 [-1, 2147483647]。 注意： 相同的请求下，模型收到不同的seed值，如：不指定seed值或令seed取值为-1（会使用随机数替代）、或手动变更seed值，将生成不同的结果。 相同的请求下，模型收到相同的seed值，会生成类似的结果，但不保证完全一致。
sequential_image_generation
string
可选
仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参 控制是否关闭组图功能；基于您输入的内容，生成的一组内容关联的图片。 auto：自动判断模式，模型会根据用户提供的提示词自主判断是否返回组图以及组图包含的图片数量。 disabled：关闭组图功能，模型只会生成一张图。 默认值 disabled
sequential_image_generation_options
object
可选
仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参 组图功能的配置。仅当 sequential_image_generation 为 auto 时生效。
max_images
integer
可选
指定本次请求，最多可生成的图片数量，取值范围： [1, 15] 默认值 15
guidance_scale
number
可选
模型输出结果与prompt的一致程度，生成图像的自由度，又称为文本权重；值越大，模型自由度越小，与用户输入的提示词相关性越强，取值范围：[1, 10] 。 doubao-seedream-3.0-t2i 默认值 2.5 doubao-seededit-3.0-i2i 默认值 5.5 doubao-seedream-5.0-lite/4.5/4.0 不支持
output_format
string
可选
仅 doubao-seedream-5.0 支持该参 指定生成图像的文件格式。可选值：
png
可选
jpeg
可选
默认值 jpeg
response_format
string
可选
指定生成图像的返回格式。支持以下两种返回方式： url：返回图片下载链接；链接在图片生成后24小时内有效，请及时下载图片。 b64_json：以 Base64 编码字符串的 JSON 格式返回图像数据。 默认值 url
watermark
boolean
可选
是否在生成的图片中添加水印。 false：不添加水印。 true：在图片右下角添加“AI生成”字样的水印标识。 默认值 true seedream-5.0/4.5/4.0 - 文生图 seedream-5.0/4.5/4.0 - 图生图 seedream-5.0/4.5/4.0 - 多图融合 seedream-5.0/4.5/4.0 - 多参考图生图 seedream-3.0-t2i seededit-3.0-i2i { "model": "doubao-seedream-5-0-260128", "prompt": "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富，眼部焦点锐利，景深较浅，具有Vogue杂志封面的美学风格，采用中画幅拍摄，工作室灯光效果强烈。", "size": "2K", "output_format": "png", "response_format": "url", "watermark": false } 请求
示例
{
"model": "doubao-seedream-5-0-260128",
"prompt": "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富，眼部焦点锐利，景深较浅，具有Vogue杂志封面的美学风格，采用中画幅拍摄，工作室灯光效果强烈。",
"size": "2K",
"output_format": "png",
"response_format": "url",
"watermark": false
}请求示例代码
curl --location --request POST 'https://api.quickrouter.ai/v1/images/generations' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "doubao-seedream-5-0-260128",
"prompt": "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富，眼部焦点锐利，景深较浅，具有Vogue杂志封面的美学风格，采用中画幅拍摄，工作室灯光效果强烈。",
"size": "2K",
"output_format": "png",
"response_format": "url",
"watermark": false
}'返回响应
响应参数 🟢 200 OK · application/json
image
可选
application/json
created
integer
必需
data
array [object]
必需
url
string
必需
{ "created": 1749819664, "data": [ { "content_filter_results": { "hate": { "filtered": false, "severity": "safe" }, "self_harm": { "filtered": false, "severity": "safe" }, "sexual": { "filtered": false, "severity": "safe" }, "violence": { "filtered": false, "severity": "safe" } }, "prompt_filter_results": { "hate": { "filtered": false, "severity": "safe" }, "profanity": { "detected": false, "filtered": false }, "self_harm": { "filtered": false, "severity": "safe" }, "sexual": { "filtered": false, "severity": "safe" }, "violence": { "filtered": false, "severity": "safe" } }, "revised_prompt": "A young, adorable sea otter floating in the ocean", "url": "https://dalleproduse.blob.core.windows.net/private/images/6b0ee3bd-fe24-46c7-8ab8-85be87b00eaf/generated_00.png?se=2025-06-14T13%3A01%3A13Z&sig=9pLM1cLo1Af6FKRZc2AZSVxfSQBBBIyzfg0cOiT7C%2B0%3D&ske=2025-06-13T23%3A43%3A31Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2025-06-06T23%3A43%3A31Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02" } ] }
示例
{
"created": 1749819664,
"data": [
{
"content_filter_results": {
"hate": {
"filtered": false,
"severity": "safe"
},
"self_harm": {
"filtered": false,
"severity": "safe"
},
"sexual": {
"filtered": false,
"severity": "safe"
},
"violence": {
"filtered": false,
"severity": "safe"
}
},
"prompt_filter_results": {
"hate": {
"filtered": false,
"severity": "safe"
},
"profanity": {
"detected": false,
"filtered": false
},
"self_harm": {
"filtered": false,
"severity": "safe"
},
"sexual": {
"filtered": false,
"severity": "safe"
},
"violence": {
"filtered": false,
"severity": "safe"
}
},
"revised_prompt": "A young, adorable sea otter floating in the ocean",
"url": "https://dalleproduse.blob.core.windows.net/private/images/6b0ee3bd-fe24-46c7-8ab8-85be87b00eaf/generated_00.png?se=2025-06-14T13%3A01%3A13Z&sig=9pLM1cLo1Af6FKRZc2AZSVxfSQBBBIyzfg0cOiT7C%2B0%3D&ske=2025-06-13T23%3A43%3A31Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2025-06-06T23%3A43%3A31Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02"
}
]
}常见错误
- 401 认证失败：检查 API Key 是否正确
- 429 请求限流：降低调用频率或升级套餐
- 500 服务器错误：稍后重试
注意事项
- 请确保 API Key 有足够的余额
- 请求频率受 API 限制，请参考价格页面