模型接口API文档图像模型Doubao Seedream
图像生成
Doubao Seedream 图像生成 API
Doubao Seedream 系列图像生成接口统一使用 /v1/images/generations，支持文生图、参考图生成、多图融合和组图生成。
curl -X POST "https://api.routescope.ai/v1/images/generations" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "prompt": "用简洁中文介绍这个 API 网关的能力。" }'{
"created": 1,
"data": {}
}Authorization
BearerAuth
AuthorizationBearer <token>
模型 relay 接口鉴权。请求头：Authorization: Bearer 。
In: header
Request Body
application/json
model*string
图片模型名称。
prompt*string
正向提示词。 提示词。范围：1 到 200000 字符，具体上限以模型官方接口为准。
n?integer
返回图片数量。 生成候选数量。范围：1 到 10；具体上限以模型官方接口为准。
Range
1 <= value <= 10logo_add?integer
水印开关：0 不带水印，1 带水印；不传默认带水印。
Default
1Value in
0 | 1size?string
生成尺寸，例如 1024x1024。
quality?string
生成质量档位。
style?string
生成风格。
response_format?string
图片返回格式，例如 url 或 b64_json。
user?string
终端用户标识。
Response Body
application/json
模型选择表
| 模型 ID | 适用场景 |
|---|---|
doubao-seedream-3-0-t2i-250415 | 中文/英文文生图，通用插画、商品图、海报草图和概念视觉生成。 |
doubao-seedream-4-0-250828 | 高质量文生图、参考图生成、多图融合和组图生成。 |
doubao-seedream-4-5-251128 | 高质量参考图生成、多图融合和高一致性图像生成。 |
doubao-seedream-5-0-260128 | 高质量参考图生成、多图融合和复杂视觉生成。 |
doubao-seedream-5-0-lite-260128 | 轻量生成、低延迟和批量草图迭代。 |
通用参数
| 字段 | 类型 | 必选 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | 无 | Seedream 模型 ID。 |
prompt | string | 是 | 无 | 生成提示词。建议明确指定主体、场景、构图、文字、风格和期望输出。 |
image | string 或 string[] | 否 | 无 | 参考图 URL 或 Base64。最多建议 14 张，参考图与生成图合计不超过 15。Seedream 3.0 不支持。 |
size | string | 否 | 见差异表 | 输出尺寸。 |
response_format | string | 否 | url | 返回格式，支持 url 或 b64_json。 |
watermark | boolean | 否 | true | 是否添加 AI 生成水印。 |
sequential_image_generation | string | 否 | disabled | 组图模式，支持 disabled 或 auto。Seedream 3.0 不支持。 |
sequential_image_generation_options.max_images | integer | 否 | 1 | 组图最大输出数量，范围 1 到 15。 |
stream | boolean | 否 | false | 是否启用流式输出。 |
user | string | 否 | 无 | 终端用户标识。 |
模型差异参数
| 字段 | 适用模型 | 默认值/范围 | 差异说明 |
|---|---|---|---|
n | doubao-seedream-3-0-t2i-250415 | 默认 1，网关通用范围 1 到 10，实际以上游限制为准 | 仅 Seedream 3.0 列出。 |
guidance_scale | doubao-seedream-3-0-t2i-250415 | 默认 2.5，取值 1 到 10 | Seedream 3.0 支持；4.0 及以上不要传。 |
size | doubao-seedream-3-0-t2i-250415 | 默认 1024x1024 | 格式如 1024x1024。 |
size | Seedream 4.0 / 4.5 / 5.0 / 5.0 Lite | 默认 2K | 支持 1K、2K、4K 或 <宽>x<高>；宽高比建议在 1:16 到 16:1。 |
stream | Seedream 3.0 / 4.0 / 4.5 / 5.0 | 默认 false | Seedream 5.0 Lite 未列出 stream。 |
示例代码
curl https://api.routescope.ai/v1/images/generations \
-H "Authorization: Bearer $ROUTESCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0-260128",
"prompt": "生成三张一致风格的 SaaS 官网首屏插画，蓝紫渐变，玻璃拟态",
"size": "2K",
"sequential_image_generation": "auto",
"sequential_image_generation_options": { "max_images": 3 },
"response_format": "url"
}'import requests
response = requests.post(
"https://api.routescope.ai/v1/images/generations",
headers={"Authorization": "Bearer YOUR_ROUTESCOPE_API_KEY"},
json={
"model": "doubao-seedream-5-0-260128",
"prompt": "生成三张一致风格的 SaaS 官网首屏插画，蓝紫渐变，玻璃拟态",
"size": "2K",
"sequential_image_generation": "auto",
"sequential_image_generation_options": {"max_images": 3},
"response_format": "url",
},
)
print(response.json())const response = await fetch("https://api.routescope.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.ROUTESCOPE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "doubao-seedream-5-0-260128",
prompt: "生成三张一致风格的 SaaS 官网首屏插画，蓝紫渐变，玻璃拟态",
size: "2K",
sequential_image_generation: "auto",
sequential_image_generation_options: { max_images: 3 },
response_format: "url",
}),
});
console.log(await response.json());响应示例
{
"created": 1777432320,
"data": [
{
"url": "https://api.routescope.ai/assets/images/seedream-5-0.png",
"b64_json": null,
"revised_prompt": "三张一致风格的 SaaS 官网首屏插画，蓝紫渐变，玻璃拟态。"
}
]
}注意事项
- 计费倍率按 Routescope 后台模型倍率与渠道倍率配置执行。
- Seedream 4.0 及以上不建议传
guidance_scale。 - 更大的
size和更多的批量输出会增加延迟与费用。
最后更新于