图片创建

授权

Authorization

string

header

必填

在请求头中传入 Authorization: Bearer <token>。

请求体

application/json

model

enum<string>

必填

图像生成模型名称。

支持的模型：

dola-seedream-5-0-pro-260628（Seedream 5.0 pro，最新推荐，支持交互编辑）
seedream-5-0-260128（Seedream 5.0，支持组图、联网搜索、流式输出）
seedream-4-5-251128（Seedream 4.5，支持 4K 与强文本渲染）
seedream-4-0-250828（Seedream 4.0，维护状态，最经济的 4K 选项）

可用选项:

dola-seedream-5-0-pro-260628,

seedream-5-0-260128,

seedream-4-5-251128,

seedream-4-0-250828

示例:

"seedream-5-0-260128"

prompt

string

必填

用于生成图像的提示词，支持中英文。建议不超过 300 个汉字或 600 个英文单词。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成图片缺失部分元素。

示例:

"充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富。"

image

输入的图片信息，支持 URL 或 Base64 编码。支持单图或多图输入。

图片 URL：请确保图片 URL 可被访问。
Base64 编码：请遵循此格式 data:image/<图片格式>;base64,<Base64编码>。注意 <图片格式> 需小写，如 data:image/png;base64,<base64_image>。

说明：

传入单张图片要求：
- 图片格式：jpeg、png、webp、bmp、tiff、gif、heic、heif
- 宽高比（宽/高）范围：[1/16, 16]
- 宽高长度（px） > 14
- 大小：不超过 30MB
- 总像素：不超过 6000×6000 = 36000000 px（对单张图宽度和高度的像素乘积限制，而不是对宽度或高度的单独值进行限制）
Seedream 5.0 pro 最多支持传入 10 张参考图；Seedream 5.0 / 4.5 / 4.0 最多支持传入 14 张参考图。

size

string

默认值:2048x2048

指定生成图像的尺寸信息，支持指定分辨率档位（如 2K）或指定宽高像素值（如 2048x2048）两种方式，不可混用。不同模型的可选分辨率、默认值、总像素取值范围、宽高比取值范围不同，请展开以下各模型对应说明查看。

dola-seedream-5-0-pro-260628（Seedream 5.0 pro）支持以下两种方式，不可混用：

方式 1（推荐）：指定分辨率档位，并在 prompt 中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。
- 默认值：2K
- 可选值：1K、2K
方式 2：指定宽高像素值（宽x高）。
- 总像素取值范围：[1280x720（921600）, 2048x2048×1.1025（4624220）]
- 宽高比取值范围：[1/16, 16]

说明：采用方式 2 时，需同时满足总像素取值范围和宽高比取值范围。其中，总像素是对单张图宽度和高度的像素乘积限制，而不是对宽度或高度的单独值进行限制。

有效示例：2048x1024 总像素值 2048x1024=2097152，符合 [921600, 4624220] 的区间要求；宽高比 2048/1024=2，符合 [1/16, 16] 的区间要求，故该示例值有效。

无效示例：512x512 总像素值 512x512=262144，未达到 921600 的最低要求，故该示例值无效。

使用方式 1 时，模型实际映射的宽高像素参考值（不限于以下标准值，仅列常见）：

分辨率	宽高比	宽高像素值
1K	1:1	1024x1024
	4:3	1152x864
	3:4	864x1152
	16:9	1424x800
	9:16	800x1424
	3:2	1248x832
	2:3	832x1248
	21:9	1568x672
2K	1:1	2048x2048
	4:3	2368x1776
	3:4	1776x2368
	16:9	2816x1584
	9:16	1584x2816
	3:2	2496x1664
	2:3	1664x2496
	21:9	3136x1344

seedream-5-0-260128（Seedream 5.0）支持以下两种方式，不可混用：

方式 1：指定分辨率，并在 prompt 中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。
- 可选值：2K、3K、4K
方式 2：指定生成图像的宽高像素值。
- 默认值：2048x2048
- 总像素取值范围：[2560x1440（3686400）, 4096x4096（16777216）]
- 宽高比取值范围：[1/16, 16]

说明：采用方式 2 时，需同时满足总像素取值范围和宽高比取值范围。其中，总像素是对单张图宽度和高度的像素乘积限制，而不是对宽度或高度的单独值进行限制。

有效示例：3750x1250 总像素值 3750x1250=4687500，符合 [3686400, 16777216] 的区间要求；宽高比 3750/1250=3，符合 [1/16, 16] 的区间要求，故该示例值有效。

无效示例：1500x1500 总像素值 1500x1500=2250000，未达到 3686400 的最低要求；宽高 1500/1500=1，虽符合 [1/16, 16] 的区间要求，但未同时满足两项限制，故该示例值无效。

采用方式 1 时，模型实际映射的宽高像素参考值：

分辨率	宽高比	宽高像素值
2K	1:1	2048x2048
	4:3	2304x1728
	3:4	1728x2304
	16:9	2848x1600
	9:16	1600x2848
	3:2	2496x1664
	2:3	1664x2496
	21:9	3136x1344
3K	1:1	3072x3072
	4:3	3456x2592
	3:4	2592x3456
	16:9	4096x2304
	9:16	2304x4096
	3:2	3744x2496
	2:3	2496x3744
	21:9	4704x2016
4K	1:1	4096x4096
	4:3	4704x3520
	3:4	3520x4704
	16:9	5504x3040
	9:16	3040x5504
	3:2	4992x3328
	2:3	3328x4992
	21:9	6240x2656

seedream-4-5-251128（Seedream 4.5）支持以下两种方式，不可混用：

方式 1：指定分辨率，并在 prompt 中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。
- 可选值：2K、4K
方式 2：指定生成图像的宽高像素值。
- 默认值：2048x2048
- 总像素取值范围：[2560x1440（3686400）, 4096x4096（16777216）]
- 宽高比取值范围：[1/16, 16]

说明：采用方式 2 时，需同时满足总像素取值范围和宽高比取值范围。其中，总像素是对单张图宽度和高度的像素乘积限制，而不是对宽度或高度的单独值进行限制。

有效示例：3750x1250 总像素值 3750x1250=4687500，符合 [3686400, 16777216] 的区间要求；宽高比 3750/1250=3，符合 [1/16, 16] 的区间要求，故该示例值有效。

无效示例：1500x1500 总像素值 1500x1500=2250000，未达到 3686400 的最低要求；宽高 1500/1500=1，虽符合 [1/16, 16] 的区间要求，但未同时满足两项限制，故该示例值无效。

采用方式 1 时，模型实际映射的宽高像素参考值：

分辨率	宽高比	宽高像素值
2K	1:1	2048x2048
	4:3	2304x1728
	3:4	1728x2304
	16:9	2848x1600
	9:16	1600x2848
	3:2	2496x1664
	2:3	1664x2496
	21:9	3136x1344
4K	1:1	4096x4096
	4:3	4704x3520
	3:4	3520x4704
	16:9	5504x3040
	9:16	3040x5504
	3:2	4992x3328
	2:3	3328x4992
	21:9	6240x2656

seedream-4-0-250828（Seedream 4.0）支持以下两种方式，不可混用：

方式 1：指定分辨率，并在 prompt 中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。
- 可选值：1K、2K、4K
方式 2：指定生成图像的宽高像素值。
- 默认值：2048x2048
- 总像素取值范围：[1280x720（921600）, 4096x4096（16777216）]
- 宽高比取值范围：[1/16, 16]

说明：采用方式 2 时，需同时满足总像素取值范围和宽高比取值范围。其中，总像素是对单张图宽度和高度的像素乘积限制，而不是对宽度或高度的单独值进行限制。

有效示例：1600x600 总像素值 1600x600=960000，符合 [921600, 16777216] 的区间要求；宽高比 1600/600=8/3，符合 [1/16, 16] 的区间要求，故该示例值有效。

无效示例：800x800 总像素值 800x800=640000，未达到 921600 的最低要求；宽高 800/800=1，虽符合 [1/16, 16] 的区间要求，但未同时满足两项限制，故该示例值无效。

采用方式 1 时，模型实际映射的宽高像素参考值：

分辨率	宽高比	宽高像素值
1K	1:1	1024x1024
	4:3	1152x864
	3:4	864x1152
	16:9	1280x720
	9:16	720x1280
	3:2	1248x832
	2:3	832x1248
	21:9	1512x648
2K	1:1	2048x2048
	4:3	2304x1728
	3:4	1728x2304
	16:9	2848x1600
	9:16	1600x2848
	3:2	2496x1664
	2:3	1664x2496
	21:9	3136x1344
4K	1:1	4096x4096
	4:3	4704x3520
	3:4	3520x4704
	16:9	5504x3040
	9:16	3040x5504
	3:2	4992x3328
	2:3	3328x4992
	21:9	6240x2656

示例:

"2K"

sequential_image_generation

enum<string>

默认值:disabled

控制是否关闭组图功能。

auto：自动判断模式，模型会根据用户提供的提示词自主判断是否返回组图以及组图包含的图片数量。
disabled：关闭组图功能，模型只会生成一张图。

仅 Seedream 5.0 / 4.5 / 4.0 支持该参数。Seedream 5.0 pro 不支持组图生成。

可用选项:

auto,

disabled

sequential_image_generation_options

object

组图功能的配置。仅当 sequential_image_generation 为 auto 时生效。

仅 Seedream 5.0 / 4.5 / 4.0 支持该参数。

Show child attributes

tools

object[]

配置模型要调用的工具。

仅 seedream-5-0-260128（Seedream 5.0）支持该参数。Seedream 5.0 pro 不支持联网搜索。

Show child attributes

示例:

[{ "type": "web_search" }]

stream

boolean

默认值:false

控制是否开启流式输出模式。

false：非流式输出模式，等待所有图片全部生成结束后再一次性返回所有信息。
true：流式输出模式，即时返回每张图片输出的结果。在生成单图和组图的场景下，流式输出模式均生效。

仅 Seedream 5.0 / 4.5 / 4.0 支持流式响应。Seedream 5.0 pro 不支持流式输出。详见「流式响应」文档。

guidance_scale

number

模型输出结果与 prompt 的一致程度，生成图像的自由度，又称为文本权重；值越大，模型自由度越小，与用户输入的提示词相关性越强。

取值范围：[1, 10]

Seedream 5.0 / 4.5 / 4.0 不支持该参数。

必填范围: 1 <= x <= 10

示例:

5

output_format

enum<string>

默认值:jpeg

指定生成图像的文件格式。

可选值：png、jpeg
仅 seedream-5-0-260128（Seedream 5.0）支持该参数。
Seedream 5.0 pro / 4.5 / 4.0 模型生成图像的文件格式默认为 jpeg，不支持自定义设置。

可用选项:

jpeg,

png

response_format

enum<string>

默认值:url

指定生成图像的返回格式。支持以下两种返回方式：

url：返回图片下载链接；链接在图片生成后 24 小时内有效，请及时下载图片。
b64_json：以 Base64 编码字符串的 JSON 格式返回图像数据。

可用选项:

url,

b64_json

watermark

boolean

默认值:true

是否在生成的图片中添加水印。

false：不添加水印。
true：在图片右下角添加「AI生成」字样的水印标识。

optimize_prompt_options

object

提示词优化功能的配置。

仅 Seedream 5.0 / 4.5 / 4.0 支持该参数。

Show child attributes

响应

调用成功，返回图像生成结果。

model

string

本次请求使用的模型 ID（模型名称-版本）。

created

integer<int64>

本次请求创建时间的 Unix 时间戳（秒）。

data

object[]

输出图像的信息。

说明：Seedream 5.0 / 4.5 / 4.0 模型生成组图场景下，组图生成过程中某张图生成失败时：

若失败原因为审核不通过：仍会继续请求下一个图片生成任务，即不影响同请求内其他图片的生成流程。
若失败原因为内部服务异常（500）：不会继续请求下一个图片生成任务。

Show child attributes

tools

object[]

本次请求，配置的模型调用工具。

Show child attributes

usage

object

本次请求的用量信息。

Show child attributes

error

object

本次请求，如发生错误，对应的错误信息。

Show child attributes

聊天模型

图像模型

视频模型

音频模型

资产库

授权

请求体

响应