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

授权

Authorization
string
header
必填

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

获取 API Key :

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

使用时在请求头中添加:

请求体

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

图像生成模型名称

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

"doubao-seedream-5.0-flash"

prompt
string
必填

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

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

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

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

示例:

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

size
string
默认值:auto

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

方式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"

quality
enum<string>
默认值:1K

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

计费说明:

  • 按张计费,1K、1.5K、2K 单价相同;1.5K、2K 画质更优且不加价
  • 使用像素格式的 size 时同样按张计费,不按像素分档
可用选项:
1K,
1.5K,
2K
示例:

"2K"

prompt_priority
enum<string>
默认值:standard

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

可选值:

  • standard:标准模式

注意: Seedream 5.0 Flash 仅支持 standard,传 fast 会返回 400。Flash 本身就是出图更快的版本,不提供快速模式。

可用选项:
standard
示例:

"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 会自动按 png 输出,指定 jpeg 会被拒绝。

可用选项:
png,
jpeg
示例:

"jpeg"

watermark
boolean
默认值:false

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

示例:

false

background
enum<string>
默认值:opaque

透明通道开关

可选值:

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

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

限制(仅对 transparent 生效):

  • 必须且只能传 1 张输入图
  • 输入图必须是 PNG,且至少含一个透明像素;webp、jpeg 等格式或不含透明像素的 PNG 会被模型拒绝(失败全额退款)
  • 输出固定为 png:不传 output_format 时自动按 png 输出,同时传 output_format=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-seedream5flash"

model
string

实际使用的模型名称

示例:

"doubao-seedream-5.0-flash"

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

使用量和计费信息