GPT-Image 参数与接口差异
了解 GPT-Image 系列模型在图片生成与编辑接口下的参数差异与使用方式。
根据所选型号调整生成、编辑及输出参数。完整请求和响应结构参阅 创建图片 和 编辑图片。
适用模型
| 模型 | 支持的接口 |
|---|---|
| gpt-image-2.6-sunburst新 gpt-image-2.6-flare新 gpt-image-2.5-sunburst gpt-image-2.5-flare gpt-image-2 gpt-image-1.5 | OpenAI Images：创建图片、编辑图片 |
生成参数差异
| 字段 | 差异说明 |
|---|---|
quality | 2.6、2.5 支持 auto/low/medium/high/xhigh/max；2、1.5 支持 auto/low/medium/high，均默认 auto |
size | 1.5 支持 auto、1024x1024、1024x1536、1536x1024；2、2.5 支持自定义尺寸，边长须为 16 的倍数且不超过 3840，宽高比为 1:3～3:1，总像素为 655360～8294400；超过 3686400 像素为实验性尺寸 |
size（2.6） | 支持 auto 或自定义尺寸，宽高为 16 的倍数、宽高比为 1:3～3:1；GIF 另受帧数与总像素预算限制，不照搬静态图片尺寸配置 |
complexity | 2.6 支持 low/medium/high，默认 high；控制生成前的规划投入，quality 控制渲染细节，两者独立设置 |
background | 透明背景显式设置 transparent，位图输出使用 png 或 webp；JPEG 不保留透明通道。2 的透明背景为官方预览能力 |
编辑参数差异
| 字段 | 差异说明 |
|---|---|
input_fidelity | 1.5 支持 low/high，默认 low；需要保留输入细节时选 high。2 始终按高保真处理，省略该字段；2.6 也应省略，不将 1.5 的配置直接套用到新型号 |
markup | 2.5、2.6 支持标注编辑；提供与第一张输入图片校正方向后尺寸一致、含透明区域的 PNG 标注层，并在提示词中说明修改内容 |
mask、markup | 二选一；多图输入时作用于第一张图片。蒙版通过透明区域指定编辑位置，标注层通过圈选、箭头等提示修改位置 |
output_format | 编辑结果使用 png/jpeg/webp；SVG、GIF 输出使用创建图片接口 |
输出格式差异
| 字段 | 差异说明 |
|---|---|
output_format | 六款均支持 png/jpeg/webp，默认 png；2.6 创建图片还支持 svg/gif |
output_compression | 仅用于 jpeg/webp，范围 0～100；PNG、SVG、GIF 省略 |
| SVG | 2.6 创建图片设置 output_format: "svg"、n: 1；不使用流式或中间图片。将 data[0].b64_json 解码后保存为 .svg，内容为 UTF-8 XML |
svg | 用于选择 SVG 编写模型，和顶层图片 model 不同；仅在开通 SVG 模型选择时填写 svg.model，否则省略整个对象。svg.reasoning 与图片 complexity 分别控制 |
| GIF | 2.6 创建图片设置 output_format: "gif"；不使用流式、中间图片或自定义压缩。将 data[].b64_json 解码后保存为 .gif |
frame_count | 仅用于 GIF，2～16 帧，默认 9；帧数、每帧尺寸与 n 共同受总像素预算限制，超限时减少其中一项 |
frame_duration_ms | 仅用于 GIF，20～2000 毫秒，默认 200，按 10 毫秒取整 |
调用示例
将 MODEL_ID 替换为平台提供的完整模型 ID；以下生成、SVG、GIF 示例使用 2.6，标注编辑使用 2.5 或 2.6。
curl 'https://api.agtcloud.ai/v1/images/generations' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"prompt": "一张简洁的咖啡馆开业海报，标题为 OPEN TODAY，排版清晰",
"quality": "medium",
"complexity": "high",
"size": "1024x1024",
"output_format": "png"
}'