/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 会原样保留,并且必须与分辨率档位一致。APIAny 会先剔除不支持请求参数的渠道,再按该次请求的预估处理成本排序,不会静默丢弃字段。