尺寸与质量
OpenAI 官方模型还允许符合约束的其他尺寸,具体条件见图片生成指南。本 API 的 Generate、Async Generate 和 Edit 当前公开三档尺寸。需要准确像素时应明确传入
size;省略后的像素尺寸不在当前公开范围内。
Generate 请求体
/v1/images/generations 完成同步生图。
统一异步请求
异步任务发送到/v1/images/tasks。生图使用 action=generate 并省略 input_images;编辑使用 action=edit,提供 1~16 张 Base64 图片:
mime_type 必须与实际 PNG、JPEG 或 WebP 字节一致。GPT Image 任务不传 aspect_ratio,可能重试时设置 Idempotency-Key。
Edit 表单
/v1/images/edits 使用 multipart。上传一张 image,同时提交 model、prompt、size、quality,n 省略或设为 1。
同步 multipart Edit 的来源图没有对外承诺固定的字节或像素上限;如果收到 HTTP 413,请缩小图片和请求体后再试。统一 JSON 任务的 Base64 解码上限仍为 20 MiB,详见错误处理与安全重试。
quality 的含义
low:较小输出预算,适合草稿类工作;medium:常规档位;high:最大公开输出预算;auto:由服务自动选择。
运行 VIP 示例
复制三类受支持请求。