Seedream 5.0 Pro 图像生成
- Seedream 5.0 Pro (doubao-seedream-5.0-pro) 模型支持文本转图片、图生图、图像编辑等多种生成模式
- 异步处理模式,使用返回的任务ID 进行查询
- 生成的图像链接,有效期为24小时,请尽快保存
授权
请求体
图像生成模型名称
doubao-seedream-5.0-pro "doubao-seedream-5.0-pro"
提示词,描述想要生成的图像,或描述如何编辑已输入的图像
语言支持: 中英文之外,Seedream 5.0 Pro 还支持俄语、阿拉伯语、菲律宾语、泰语、土耳其语、韩语、马来语、西班牙语、葡萄牙语、印尼语、法语、德语、越南语、日语。
长度限制: 最多 4000 tokens(中文约 2600 字、英文约 5000 词),超出返回 400 且不计费。
效果建议: 建议中文不超过 300 字、英文不超过 600 词。过长虽在限额内,但信息容易分散,模型可能忽略细节导致画面元素缺失。
"一片宁静的湖水倒映着夕阳的美景"
生成图像的尺寸,支持两种格式:
方式1 - 比例格式:
auto、1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、9:21- 配合
quality参数使用,系统自动生成对应比例和分辨率的图片,无需手动指定像素
方式2 - 像素格式:
- 宽度x高度,如:
1024x1024、2048x2048等在范围内的值 - 总像素取值范围:
[921600, 4624220] - 宽高比取值范围:
[1/16, 16] - 宽高均需大于
14px
不传 size 时默认 auto。auto 表示不指定具体比例,由模型依据 prompt 自行判断构图,输出分辨率取 quality 指定的档位。
"16:9"
分辨率档位,与 size 的比例格式配合使用,默认 1K。
计费说明:
1K与1.5K单价相同,1.5K画质更优,推荐优先使用1.5K- 使用像素格式的
size时,按实际输出总像素判档:不超过2610000走低档价,超过则走高档价
1K, 1.5K, 2K "2K"
提示词优化策略,用于设置提示词优化功能的模式
可选值:
standard:标准模式,生成内容质量更高,耗时较长fast:快速模式,生成耗时更短,效果略低于标准模式
standard, fast "standard"
参考图像URL列表,用于图生图与图像编辑功能
注意:
- 单次请求支持输入图像数量:
10张 - 图像大小:不超过
30MB - 支持的图像格式:
.jpeg、.jpg、.png、.webp、.bmp、.tiff、.gif、.heic、.heif - 宽高比(宽/高)范围:
[1/16, 16] - 宽高长度(px)> 14
- 总像素范围:
[196, 6000×6000] - 图像URL需要服务器能直接查看,或者图像URL在访问时会直接进行下载(一般这种URL是以图像的扩展名作为结尾,例如
.png、.jpg)
10输出图片格式
可选值:
png: PNG 格式jpeg: JPEG 格式
注意: 传 background=transparent 时输出固定为 png,此时再指定 output_format=jpeg 会被拒绝。
png, jpeg "jpeg"
是否在生成图像中添加水印
false
透明通道开关
可选值:
opaque:常规实底背景(默认)transparent:保留输入图已有的透明通道
transparent是保留输入图原有的透明背景,不是抠图去背景。
限制(仅对 transparent 生效):
- 必须且只能传 1 张输入图,且该图本身带透明通道
- 输出固定为 png,同时传
output_format=jpeg会被拒绝 - 输入图为不支持透明通道的格式(如 jpeg)会被模型拒绝
opaque, transparent "opaque"
任务完成后的HTTPS回调地址
回调时机:
- 任务完成(completed)、失败(failed)或取消(cancelled)时触发
- 在计费确认完成后发送
安全限制:
- 仅支持HTTPS协议
- 禁止回调到内网IP地址(127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等)
- URL长度不超过
2048字符
回调机制:
- 超时时间:
10秒 - 失败后最多重试
3次(会分别在失败的1秒/2秒/4秒后进行重试) - 回调响应体格式与任务查询接口返回的格式一致
- 回调地址若返回2xx状态码视为成功,其他状态码会触发重试
"https://your-domain.com/webhooks/image-task-completed"
响应
图像生成任务创建成功
任务创建时间戳
1757165031
任务ID
"task-unified-1757165031-seedream5pro"
实际使用的模型名称
"doubao-seedream-5.0-pro"
任务的具体类型
image.generation.task 任务进度百分比 (0-100)
0 <= x <= 1000
任务状态
pending, processing, completed, failed "pending"
异步任务信息
任务的输出类型
text, image, audio, video "image"
使用量和计费信息