doubao-seedream-5.0-pro接口
Seedream
Seedream 5.0 Pro 图像生成
- Seedream 5.0 Pro (doubao-seedream-5.0-pro) 模型支持文本转图片、图生图、图像编辑等多种生成模式
- 异步处理模式,使用返回的任务ID 进行查询
- 生成的图像链接,有效期为24小时,请尽快保存
POST
doubao-seedream-5.0-pro接口
授权
请求体
application/json
图像生成模型名称
可用选项:
doubao-seedream-5.0-pro 示例:
"doubao-seedream-5.0-pro"
提示词,描述想要生成的图像,或描述如何编辑已输入的图像,限制为2000token
Maximum string length:
2000示例:
"一片宁静的湖水倒映着夕阳的美景"
规定生成图像的数量,Pro 仅支持 1
注意:
- 单次请求会根据
n的值进行预扣费,实际扣费以生成图像数量为准
示例:
1
生成图像的尺寸,支持两种格式:
方式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
示例:
"16:9"
分辨率档位,与 size 的比例格式配合使用,默认 1K。
可用选项:
1K, 2K 示例:
"2K"
提示词优化策略,用于设置提示词优化功能的模式
可选值:
standard:标准模式,生成内容质量更高,耗时较长
可用选项:
standard 示例:
"standard"
参考图像URL列表,用于图生图与图像编辑功能
注意:
- 单次请求支持输入图像数量:
10张 - 图像大小:不超过
30MB - 支持的图像格式:
.jpeg、.jpg、.png、.webp、.bmp、.tiff、.gif、.heic、.heif - 宽高比(宽/高)范围:
[1/16, 16] - 宽高长度(px)> 14
- 总像素:不超过
6000×6000 - 图像URL需要服务器能直接查看,或者图像URL在访问时会直接进行下载(一般这种URL是以图像的扩展名作为结尾,例如
.png、.jpg)
Maximum array length:
10示例:
输出图片格式
可选值:
png: PNG 格式jpeg: JPEG 格式
可用选项:
png, jpeg 示例:
"jpeg"
是否在生成图像中添加水印
示例:
false
任务完成后的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 <= 100示例:
0
任务状态
可用选项:
pending, processing, completed, failed 示例:
"pending"
异步任务信息
任务的输出类型
可用选项:
text, image, audio, video 示例:
"image"
使用量和计费信息