Seedream 4.0 图生图
支持模型包括 seedream-4-0-250828。本文档覆盖图生图与多图参考生成场景。公开字段包括 model、prompt、image、size、seed、sequential_image_generation、sequential_image_generation_options、response_format、watermark。
授权
在请求头中传入 Authorization: Bearer <token>。
请求体
图像生成模型名称。支持的模型包括 seedream-4-0-250828。
seedream-4-0-250828 用于生成图像的提示词,支持中英文。建议不超过 300 个汉字或 600 个英文单词。字数过多信息容易分散,模型可能因此忽略细节,只关注重点,造成图片缺失部分元素。
"充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富。"
输入的图片信息,支持 URL 或 Base64 编码。seedream 4.0 支持单图或多图输入。
- 图片 URL:请确保图片 URL 可被访问。
- Base64 编码:请遵循此格式
data:image/<图片格式>;base64,<Base64编码>。注意<图片格式>需小写,如data:image/png;base64,<base64_image>。
说明:
- 传入单张图片要求:
- 图片格式:jpeg、png(seedream 4.0 新增支持 webp、bmp、tiff、gif、heic、heif 格式)
- 宽高比(宽/高)范围:[1/16, 16](适用模型:seedream 4.0)
- 宽高长度(px) > 14
- 大小:不超过 30MB
- 总像素:不超过 6000×6000 = 36000000 px(对单张图宽度和高度的像素乘积限制,而不是对宽度或高度的单独值进行限制)
- seedream 4.0 最多支持传入 14 张参考图。
指定生成图像的尺寸信息。不同模型支持的尺寸方式存在差异。
seedream-4-0-250828: 指定生成图像的尺寸信息,支持以下两种方式,不可混用。
-
方式 1 | 指定生成图像的宽高像素值:
-
默认值:
2048x2048 -
总像素取值范围:[
1280x720(921600),4096x4096(16777216)] -
宽高比取值范围:[1/16, 16]
说明:采用方式 1 时,需同时满足总像素取值范围和宽高比取值范围。其中,总像素是对单张图宽度和高度的像素乘积限制,而不是对宽度或高度的单独值进行限制。
- 有效示例:
1600x600总像素值 1600x600=960000,符合 [921600, 16777216] 的区间要求;宽高比 1600/600=8/3,符合 [1/16, 16] 的区间要求,故该示例值有效。 - 无效示例:
800x800总像素值 800x800=640000,未达到 921600 的最低要求;宽高 800/800=1,虽符合 [1/16, 16] 的区间要求,但因其未同时满足两项限制,故该示例值无效。
-
-
方式 2 | 指定生成图像的分辨率,并在 prompt 中用自然语言描述图片宽高比、图片形状或图片用途,最终由模型判断生成图片的大小。
- 可选值:
1K、2K、4K
说明:采用方式 2 并在 prompt 中描述特定宽高比时,模型实际映射的宽高像素参考值:
- 可选值:
"2K"
指定生成图像的返回格式。支持以下两种返回方式:
url:返回图片下载链接;链接在图片生成后 24 小时内有效,请及时下载图片。b64_json:以 Base64 编码字符串的 JSON 格式返回图像数据。
url, b64_json 随机数种子。部分 Seedream 模型支持。取值范围 [-1, 2147483647]。
-1 <= x <= 2147483647控制是否关闭组图功能。
auto:自动判断模式,模型会根据用户提供的提示词自主判断是否返回组图以及组图包含的图片数量。disabled:关闭组图功能,模型只会生成一张图。
仅 seedream 5.0/4.5/4.0 支持该参数。
auto, disabled 组图功能的配置。仅当 sequential_image_generation 为 auto 时生效。
仅 seedream 5.0/4.5/4.0 支持该参数。
是否在生成的图片中添加水印。
false:不添加水印。true:在图片右下角添加「AI生成」字样的水印标识。