Skip to main content
POST

授权

Authorization
string
header
必填

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

请求体

application/json
model
enum<string>
必填

图像生成模型名称。支持的模型包括 dola-seedream-5-0-pro-260628(Seedream 5.0 pro,支持交互编辑,不支持组图生成)。

可用选项:
dola-seedream-5-0-pro-260628
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 张参考图。
size
string
默认值:2K

指定生成图像的尺寸信息,支持指定分辨率档位(如 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 时,模型实际映射的宽高像素参考值(不限于以下标准值,仅列常见):

示例:

"2K"

response_format
enum<string>
默认值:url

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

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

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

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

响应

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

model
string

本次请求使用的模型 ID(模型名称-版本)。

created
integer<int64>

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

data
object[]

生成的图像列表。

usage
object

本次请求的用量信息。