/v1/images/generations 创建异步图片任务。
GPT-Image 2 尺寸与质量
调用gpt-image-2 时,推荐直接传入原生像素尺寸或 auto:
auto 或七个官方常用尺寸之一:1024x1024、1536x1024、1024x1536、2048x2048、2048x1152、3840x2160、2160x3840。APIAny 也接受任意正整数 宽x高 作为目标尺寸,并在保持方形、横图或竖图方向的前提下映射到最接近的常用尺寸。例如,1280x720 映射为 1536x1024,1920x1080 映射为 2048x1152,1440x2560 映射为 2160x3840。
quality 可选 auto、low、medium、high,默认是 auto。n 支持 1–10,并按实际生成图片数量逐张计费。比例简写(例如 size: "4:3")仍可与兼容参数 resolution: "1K"、"2K" 或 "4K" 组合使用;APIAny 会先计算目标尺寸,再执行相同的最近官方常用尺寸映射。只传 aspect_ratio、resolution 或 img_size 的旧请求仍然兼容。新接入建议优先使用 auto 或七个官方常用尺寸,以获得可预期的输出与计费结果。
同步等待接口
/v1/images/generations/sync 会等待生成结果返回,或在达到最大等待时间后返回当前状态。
该接口适合兼容 OpenAI Images 风格或调试场景。生产系统建议使用异步接口。
图片编辑
/v1/images/edits 用于 OpenAI 风格图片编辑。只有支持参考图的模型可以调用该接口。
GPT Image 2.5 档位与参数支持
gpt-image-2.5 固定为 Flare 别名;需要精细编辑时请显式使用 gpt-image-2.5-sunburst。quality 与 resolution 相互独立:质量支持 auto/low/medium/high/xhigh/max,分辨率支持 1K/2K/4K。显式像素 size 会原样保留,并且必须与分辨率档位一致。请求参数须在所选模型的支持范围内,不支持的字段不会被静默丢弃。
GPT Image 2.6
gpt-image-2.6 在现有图片接口中支持 PNG 和 GIF 动图请求,无需单独的 GIF API。每次成功请求 30 积分,返回一个结果。调用前请通过 GET /v1/models 确认是否可用。
使用 output_format: "png"(默认)或 "gif"、quality: "auto"、resolution: "1K" 和 n: 1。size 可选 auto、1:1、3:2、2:3、1024x1024、1536x1024 或 1024x1536,最多一张参考图。别名和 model_params 同样受限,冲突值返回 HTTP 400。
不支持 SVG、JPEG、WebP、2K/4K、蒙版、压缩、frame_count 和 frame_duration_ms。GIF 尺寸、帧数与帧间隔不可配置。background 可省略,仅接受 auto。SVG 请求返回 HTTP 400,不会返回 PNG 代替。
同步等待 PNG
使用一张参考图生成 GIF
编辑接口支持 JSON 的单个image_urls 地址,或 multipart 的 image 文件,请勿添加蒙版。使用 output_format 选择结果格式,GIF 编辑同样返回一个动图文件。
200,文件位于 data[0].url;仍在等待时返回 HTTP 202、task_id 和 poll_url。通过 /v1/tasks/{task_id} 查询至 completed 或 failed,pending 或 processing 时继续使用同一任务 ID。异步生成使用 /v1/images/generations,完成文件位于 result.data[0].url。无效或静态 GIF 结果会失败,并按常规失败任务积分退款规则处理。
完整参数、异步 PNG/GIF 示例和轮询响应