Skip to main content
POST

授权

Authorization
string
header
必填

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

请求体

application/json
model
enum<string>
必填

图像生成模型名称。支持的模型包括 seedream-5-0-260128

可用选项:
seedream-5-0-260128
prompt
string
必填

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

示例:

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

image

输入的图片信息,支持 URL 或 Base64 编码。seedream 5.0/4.5/4.0 支持单图或多图输入。

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

说明:

  • 传入单张图片要求:
    • 图片格式:jpeg、png(seedream 5.0/4.5/4.0 新增支持 webp、bmp、tiff、gif、heic、heif 格式)
    • 宽高比(宽/高)范围:[1/16, 16](适用模型:seedream 5.0/4.5/4.0)
    • 宽高长度(px) > 14
    • 大小:不超过 30MB
    • 总像素:不超过 6000×6000 = 36000000 px(对单张图宽度和高度的像素乘积限制,而不是对宽度或高度的单独值进行限制)
  • seedream 5.0/4.5/4.0 最多支持传入 14 张参考图。
size
string
默认值:2K

指定生成图像的尺寸信息。不同模型支持的尺寸方式存在差异。

seedream-5-0-260128: 指定生成图像的尺寸信息,支持以下两种方式,不可混用。

  • 方式 1 | 指定生成图像的宽高像素值:

    • 默认值:2048x2048

    • 总像素取值范围:[2560x1440(3686400), 4096x4096(16777216)]

    • 宽高比取值范围:[1/16, 16]

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

    • 有效示例:3750x1250 总像素值 3750x1250=4687500,符合 [3686400, 16777216] 的区间要求;宽高比 3750/1250=3,符合 [1/16, 16] 的区间要求,故该示例值有效。
    • 无效示例:1500x1500 总像素值 1500x1500=2250000,未达到 3686400 的最低要求;宽高 1500/1500=1,虽符合 [1/16, 16] 的区间要求,但因其未同时满足两项限制,故该示例值无效。
  • 方式 2 | 指定生成图像的分辨率,并在 prompt 中用自然语言描述图片宽高比、图片形状或图片用途,最终由模型判断生成图片的大小。

    • 可选值:2K3K4K

    说明:采用方式 2 并在 prompt 中描述特定宽高比时,模型实际映射的宽高像素参考值:

示例:

"2048x2048"

response_format
enum<string>
默认值:url

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

  • url:返回图片下载链接;链接在图片生成后 24 小时内有效,请及时下载图片。
  • b64_json:以 Base64 编码字符串的 JSON 格式返回图像数据。
可用选项:
url,
b64_json
seed
integer
默认值:-1

随机数种子。部分 Seedream 模型支持。取值范围 [-1, 2147483647]。

必填范围: -1 <= x <= 2147483647
sequential_image_generation
enum<string>
默认值:disabled

控制是否关闭组图功能。

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

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

可用选项:
auto,
disabled
sequential_image_generation_options
object

组图功能的配置。仅当 sequential_image_generationauto 时生效。

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

watermark
boolean
默认值:true

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

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

响应

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

created
integer<int64>

创建时间的 Unix 时间戳(秒)。

data
object[]

生成的图像列表。组图场景下可能包含多张图片。