创建图片

POST

/v1/images/generations

• 给定提示和/或输入图像，模型将生成新图像。
• 支持文生图、图生图、多图融合等场景。
• 支持 seedream-5.0/4.5/4.0/3.0-t2i 及 seededit-3.0-i2i 多种模型。

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

• 支持：文生图
  • 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

用于生成图像的提示词。

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

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

默认值 url

string

仅 doubao-seedream-3.0-t2i/seededit-3.0-i2i 支持该参
随机数种子，用于控制模型生成内容的随机性。取值范围为 [-1, 2147483647]。
注意：

• 相同的请求下，模型收到不同的seed值，如：不指定seed值或令seed取值为-1（会使用随机数替代）、或手动变更seed值，将生成不同的结果。
• 相同的请求下，模型收到相同的seed值，会生成类似的结果，但不保证完全一致。

模型输出结果与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 不支持

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

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

默认值 true

string |array

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

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

仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参
控制是否关闭组图功能；基于您输入的内容，生成的一组内容关联的图片。

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

默认值 disabled

object

仅 doubao-seedream-5.0-lite/4.5/4.0 支持该参
组图功能的配置。仅当 sequential_image_generation 为 auto 时生效。

仅 doubao-seedream-5.0 支持该参
指定生成图像的文件格式。可选值：

• png
• jpeg

默认值 jpeg