模型名称seedream-5.0-pro
  • 面向高规格中文视觉创作、多参考图一致性生成和高质量海报场景
  • 对外统一走图片异步任务协议,提交成功后返回 task_id
  • 支持文生图、单图生图与多参考图生图
  • size 支持 1:14:33:416:99:163:22:321:9auto
  • resolution 支持 1k1.5k2k
  • 除比例尺寸外,支持受限范围内的精确像素 size,例如 1600x1600
  • images 最多支持 10
  • output_format 支持 jpegpng

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。 获取 API Key:从平台上获取。 使用时在请求头中添加:

提交任务接口

提交图片异步任务。接口受理成功后会立即返回 task_id,实际图片结果需要通过任务查询接口继续轮询。

请求参数

说明:
  1. images 统一使用数组传入,单图也使用数组。
  2. 比例 size 支持:1:14:33:416:99:163:22:321:9auto
  3. 也可传精确像素 size="宽x高",如 1600x16002048x1024;总像素必须在 921600..4624220,宽高比必须在 1:16..16:1。精确像素尺寸下会忽略 resolution
  4. resolution 支持:1k1.5k2k
  5. 当前正式对外页固定单张生成,不开放 n > 1size=auto 时必须提供至少一张参考图。
  6. output_format 只控制生成文件格式;提交后仍须通过异步查询读取 works[].asset_url

响应

成功响应示例:
失败响应示例:

任务查询接口

使用提交阶段返回的 task_id 查询当前任务状态。任务成功后,可从结果对象里读取图片地址。 统一规则:响应体 code 为数字 200works 始终是有序数组;处理中或失败时返回空数组。images 表示输入参考图,works 表示输出作品。完整状态和多作品示例见 异步任务查询

响应

查询结果示例:

使用示例

文生图

多参考图生图

精确像素尺寸

该示例中 resolution 会被忽略,最终尺寸由 size 的精确像素值决定。

注意事项

  1. 当前正式对外页固定单张生成,不开放多张批量生成。
  2. images 最多支持 10 张;size=auto 时必须至少传一张参考图。
  3. 精确像素尺寸仅接受本页列出的像素总量和宽高比范围,不要将其与比例尺寸混用。
  4. 提交成功后请使用返回的 task_id 轮询任务结果。