Skip to main content
POST
国内用户请注意: 中国大陆用户请使用 https://toapis.xyz 作为接口地址(Base URL)。文档示例中的 https://toapis.com 请替换为 https://toapis.xyz
  • Seedream 5.0 Pro 高质量图像生成模型,由字节跳动 Seed 团队研发
  • 通过 model 参数选择 doubao-seedream-5-0-pro 模型
  • 参数与 Seedream-5.0 基本一致,区别在于 Pro 支持 1K2K 分辨率
  • 支持文生图、图生图、多图参考等生成模式
  • 计费规则:首张参考图免费,从第 2 张参考图开始按正常规则计费
  • 异步任务管理,通过任务 ID 查询结果
重要变更:为了更好的性能和成本控制,我们不再支持在 image_urls 中直接传入 base64 图片数据。请先使用 上传图片接口 上传图片,获取 URL 后再调用本接口。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

string
默认值:"doubao-seedream-5-0-pro"
必填
图像生成模型名称示例:"doubao-seedream-5-0-pro"
string
必填
图像生成的文本描述
string
默认值:"1:1"
图像宽高比启用 layer_decomposition 时,该字段改为直接传入分辨率预设 1K2K支持的宽高比:
  • 1:1 - 正方形(默认)
  • 4:3 - 横向 4:3
  • 3:4 - 竖向 3:4
  • 16:9 - 横向宽屏
  • 9:16 - 竖向长图
  • 3:2 - 横向 3:2
  • 2:3 - 竖向 2:3
  • 21:9 - 超宽屏
  • 9:21 - 超窄屏
integer
默认值:1
生成图像的数量范围:1-10(最少 1 张,最多 10 张)默认:1注意:
  • 参考图像 + 生成图像总数必须 ≤ 15
  • 必须输入纯数字(如 1),不要加引号,否则会报错
会根据生成数量和参考图数量进行预扣费,其中首张参考图免费
boolean
默认值:false
是否启用 Seedream 5.0 Pro 专属的图层拆分能力。
  • false:返回普通的扁平图像(默认)
  • true:返回底图和多个带透明通道的独立 PNG 图层
开启后,任务查询结果的每个 result.data[] 项还会返回 z_index;独立图层会额外返回 bounding_boxnamedescription。该参数仅支持 Seedream 5.0 Pro。
string[]
参考图像 URL 列表,用于图生图或图像编辑⚠️ 仅支持 URL 格式(不再支持 base64)
  • 公开可访问的图像 URL(http:// 或 https://)
  • 可使用 上传图片接口 上传本地图片获取 URL
限制:
  • 图片数量:1-10 张
  • 图像格式:jpeg, png
  • 宽高比(宽/高)范围:[1/3, 3]
  • 宽度和高度(px)> 14
  • 大小:不超过 10MB
  • 总像素:不超过 6000×6000 px
计费说明:
  • 首张参考图免费
  • 从第 2 张参考图开始按正常规则计费
object
渠道特有参数,用于传递 Seedream 5.0 Pro 模型的高级配置

Response

string
任务唯一标识符,用于查询任务状态
string
对象类型,固定为 generation.task
string
使用的模型名称
string
任务状态
  • queued - 排队等待处理
  • in_progress - 处理中
  • completed - 成功完成
  • failed - 失败
integer
任务进度百分比(0-100)
integer
任务创建时间戳(Unix 时间戳)
object
任务元数据
integer
任务完成时间戳(Unix 时间戳)。仅在任务完成后返回。
integer
结果文件的过期时间戳(Unix 时间戳)。请在过期前下载或转存结果文件。
object
任务成功后的生成结果。仅当 statuscompleted 时返回。
string
结果类型,图片任务固定为 image
array
图片结果列表。开启图层拆分时,第一个元素通常为底图,其余元素为带透明通道的独立 PNG 图层。
string
底图或独立图层的公开访问地址。
integer
图层叠放顺序。开启 layer_decomposition 时,底图通常为 0,独立图层依次递增。
string
当前底图或独立图层的像素尺寸,例如 2048x2048
string
当前结果项的文件格式。底图可为请求的格式,透明独立图层为 png
object
独立图层在底图中的位置,包含 absolute 绝对坐标和 normalized 归一化坐标。
array
图层在底图中的绝对像素坐标,格式为 [x1, y1, x2, y2],分别表示左上角和右下角坐标。
array
图层的归一化坐标,格式为 [x1, y1, x2, y2],坐标范围为 0-1000
string
图层名称。
string
图层内容描述。