跳转到主要内容
POST
  • 异步接口:提交后立即返回 task_id,再调用 查询图片任务 获取结果。
  • 不传 image_urls 为文生图;传入 image_urls 为图生图 / 参考图模式。
  • 生成的图片不带水印。
  • 按张计费,单价由分辨率档位决定,见 模型价格。任务失败自动退款。

鉴权

string
必填
Bearer <API Key>。在 API 密钥 页面创建。

请求参数

string
默认值:"seedream-5-5"
必填
模型 ID,填 seedream-5-5。
string
必填
图像描述,支持中英文。建议写清主体、场景、构图、风格和光线。
string
输出比例,或精确像素尺寸。支持 8 种比例:1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9。传比例时必须同时传 resolution。也可以直接传像素尺寸,例如 2048x2048,此时忽略 resolution。
string
分辨率档位:1K、1.5K 或 2K,大小写均可。与比例形式的 size 一起决定实际像素,见下方对照表。
string[]
参考图列表,传入后为图生图 / 参考图模式。

尺寸对照表

size 与 resolution 组合后的实际输出像素:
传比例但不传 resolution,或传了表中没有的比例(如 5:4),请求会返回错误。

提交响应

integer
固定为 200。
string
固定为 submitted。
string
任务 ID,用于 查询图片任务。
string
与 task_id 相同。

使用示例

文生图(1K 方图)
2K 竖版海报
直接指定像素尺寸
图生图(参考图 URL)
多图融合(URL 与 Base64 混填)

查询结果

取图方式:data[0].url。状态说明见 查询图片任务。