同步文生图
JSON 字段如下:/v1/images/generations。
下游存储或排版依赖准确像素时,必须明确传入 size;当前公开接口不定义省略该字段后得到的像素尺寸。
统一异步请求
异步任务发送到/v1/images/tasks。生图使用 action=generate 并省略 input_images;编辑可提供 1~16 张图片,下面用两张参考图组合画面:
data 只填写不带 data URL 前缀的 Base64;每张图解码后不超过 20 MiB,全部来源图合计不超过 64 MiB;mime_type 必须与 PNG、JPEG 或 WebP 文件字节一致。不要传 aspect_ratio。
可能重试的提交应设置最长 255 字节的 Idempotency-Key。同一键和请求体复用原任务,请求体变化时返回 HTTP 409。
图生图表单
POST /v1/images/edits 使用 multipart/form-data:
model、prompt、image必填;image可上传 PNG、JPEG 或 WebP;size使用三档之一;n省略或使用1;quality使用low、medium、high或auto,效果取决于上游。
413,请缩小图片和请求体后再试。统一 JSON 任务的 Base64 解码上限仍为 20 MiB,详见错误处理与安全重试。
返回值
成功结果在data[0].b64_json:
url 字段。
同步 Edit 只上传一张来源图,多图任务使用统一异步接口。当前逆向接口不开放蒙版、n > 1、partial image 流、输出格式与压缩、透明背景、回调和取消。成功任务保留原生 ImagesResponse,图片在完成 24 小时后过期。
运行 Web 示例
复制同步、异步和编辑代码。