Skip to main content
POST
doubao-seedream-5.0-pro接口

授权

Authorization
string
header
必填

##所有接口均需要使用Bearer Token进行认证##

获取 API Key :

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

请求体

application/json
model
enum<string>
默认值:doubao-seedream-5.0-pro
必填

图像生成模型名称

可用选项:
doubao-seedream-5.0-pro
示例:

"doubao-seedream-5.0-pro"

prompt
string
必填

提示词,描述想要生成的图像,或描述如何编辑已输入的图像

语言支持: 中英文之外,Seedream 5.0 Pro 还支持俄语、阿拉伯语、菲律宾语、泰语、土耳其语、韩语、马来语、西班牙语、葡萄牙语、印尼语、法语、德语、越南语、日语。

长度限制: 最多 4000 tokens(中文约 2600 字、英文约 5000 词),超出返回 400 且不计费。

效果建议: 建议中文不超过 300 字、英文不超过 600 词。过长虽在限额内,但信息容易分散,模型可能忽略细节导致画面元素缺失。

示例:

"一片宁静的湖水倒映着夕阳的美景"

size
string
默认值:auto

生成图像的尺寸,支持两种格式:

方式1 - 比例格式:

  • auto1:12:33:23:44:34:55:49:1616:921:99:21
  • 配合 quality 参数使用,系统自动生成对应比例和分辨率的图片,无需手动指定像素

方式2 - 像素格式:

  • 宽度x高度,如:1024x10242048x2048等在范围内的值
  • 总像素取值范围:[921600, 4624220]
  • 宽高比取值范围:[1/16, 16]
  • 宽高均需大于 14px

不传 size 时默认 autoauto 表示不指定具体比例,由模型依据 prompt 自行判断构图,输出分辨率取 quality 指定的档位。

示例:

"16:9"

quality
enum<string>
默认值:1K

分辨率档位,与 size 的比例格式配合使用,默认 1K

计费说明:

  • 1K1.5K 单价相同,1.5K 画质更优,推荐优先使用 1.5K
  • 使用像素格式的 size 时,按实际输出总像素判档:不超过 2610000 走低档价,超过则走高档价
可用选项:
1K,
1.5K,
2K
示例:

"2K"

prompt_priority
enum<string>
默认值:standard

提示词优化策略,用于设置提示词优化功能的模式

可选值:

  • standard:标准模式,生成内容质量更高,耗时较长
  • fast:快速模式,生成耗时更短,效果略低于标准模式
可用选项:
standard,
fast
示例:

"standard"

image_urls
string<uri>[]

参考图像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
Maximum array length: 10
示例:
output_format
enum<string>
默认值:jpeg

输出图片格式

可选值:

  • png: PNG 格式
  • jpeg: JPEG 格式

注意:background=transparent 时输出固定为 png,此时再指定 output_format=jpeg 会被拒绝。

可用选项:
png,
jpeg
示例:

"jpeg"

watermark
boolean
默认值:false

是否在生成图像中添加水印

示例:

false

background
enum<string>
默认值:opaque

透明通道开关

可选值:

  • opaque:常规实底背景(默认)
  • transparent:保留输入图已有的透明通道

transparent保留输入图原有的透明背景,不是抠图去背景

限制(仅对 transparent 生效):

  • 必须且只能传 1 张输入图,且该图本身带透明通道
  • 输出固定为 png,同时传 output_format=jpeg 会被拒绝
  • 输入图为不支持透明通道的格式(如 jpeg)会被模型拒绝
可用选项:
opaque,
transparent
示例:

"opaque"

callback_url
string<uri>

任务完成后的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"

响应

图像生成任务创建成功

created
integer

任务创建时间戳

示例:

1757165031

id
string

任务ID

示例:

"task-unified-1757165031-seedream5pro"

model
string

实际使用的模型名称

示例:

"doubao-seedream-5.0-pro"

object
enum<string>

任务的具体类型

可用选项:
image.generation.task
progress
integer

任务进度百分比 (0-100)

必填范围: 0 <= x <= 100
示例:

0

status
enum<string>

任务状态

可用选项:
pending,
processing,
completed,
failed
示例:

"pending"

task_info
object

异步任务信息

type
enum<string>

任务的输出类型

可用选项:
text,
image,
audio,
video
示例:

"image"

usage
object

使用量和计费信息