Skip to main content
请求中的模型名固定为:

同步文生图

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
  • modelpromptimage 必填;
  • image 可上传 PNG、JPEG 或 WebP;
  • size 使用三档之一;
  • n 省略或使用 1
  • quality 使用 lowmediumhighauto,效果取决于上游。
当前同步 Edit 只接受一张来源图片,不含蒙版。multipart 来源图没有对外承诺固定的字节或像素上限;如果收到 HTTP 413,请缩小图片和请求体后再试。统一 JSON 任务的 Base64 解码上限仍为 20 MiB,详见错误处理与安全重试

返回值

成功结果在 data[0].b64_json
Base64 解码后按 PNG 保存,不要等待 url 字段。 同步 Edit 只上传一张来源图,多图任务使用统一异步接口。当前逆向接口不开放蒙版、n > 1、partial image 流、输出格式与压缩、透明背景、回调和取消。成功任务保留原生 ImagesResponse,图片在完成 24 小时后过期。

运行 Web 示例

复制同步、异步和编辑代码。
最后修改于 2026年9月3日