Skip to main content
POST
创建图像编辑

Authorizations

Authorization
string
header
required

OpenAI API密钥认证。在 Authorization HTTP Header 中包含您的 API-Key,格式为 Bearer {API_KEY}

Body

image
required

要编辑的图像。必须是支持的图像文件或图像数组。对于 gpt-image-1,每个图像应为 png、webp 或 jpg 文件,小于 50MB。最多可提供 16 个图像。对于 dall-e-2,只能提供一个图像,且应为正方形 png 文件,小于 4MB

prompt
string
required

描述所需图像的文本提示。dall-e-2 最大长度为 1000 个字符,gpt-image-1 最大长度为 32000 个字符

Maximum string length: 32000
Example:

"在图片中添加一朵红色的玫瑰花"

model
enum<string> | null
required

用于图片编辑的模型。新接入推荐 gpt-image-2.5-sunburst;低延迟场景可选 gpt-image-2.5-flare

Available options:
gpt-image-2.5-flare,
gpt-image-2.5-sunburst,
gpt-image-2-2026-04-21,
gpt-image-2,
gpt-image-1.5,
gpt-image-1-mini,
gpt-image-1,
dall-e-2
Example:

"gpt-image-2.5-sunburst"

background
enum<string> | null
default:auto

设置生成图像背景的透明度。此参数仅支持 gpt-image-1。必须是 transparent、opaque 或 auto(默认值)之一。当使用 auto 时,模型将自动确定图像的最佳背景。如果是 transparent,输出格式需要支持透明度,因此应设置为 png(默认值)或 webp

Available options:
transparent,
opaque,
auto
input_fidelity
enum<string>

控制模型匹配输入图片风格和特征的努力程度。GPT Image 2.5 当前仅 gpt-image-2.5-sunburst 支持 high;Flare 请省略此字段。其他模型以模型说明为准

Available options:
high,
low
mask
file

一个额外的图像,其完全透明的区域(例如 alpha 为零的地方)指示应该编辑图像的位置。如果提供了多个图像,mask 将应用于第一个图像。必须是有效的 PNG 文件,小于 4MB,并且与图像具有相同的尺寸

n
integer | null
default:1

要生成的图像数量。必须在 1 到 10 之间

Required range: 1 <= x <= 10
output_compression
integer | null
default:100

生成图像的压缩级别(0-100%)。此参数仅支持使用 webp 或 jpeg 输出格式的 gpt-image-1,默认为 100

Required range: 0 <= x <= 100
output_format
enum<string> | null
default:png

输出图片格式。GPT Image 2.5 当前平台接入支持 png 或 jpeg,暂不支持 webp

Available options:
png,
jpeg,
webp
partial_images
integer
default:0

要生成的部分图像数量。此参数用于返回部分图像的流式响应。值必须在 0 到 3 之间。当设置为 0 时,响应将是在一个流式事件中发送的单个图像。注意,如果完整图像生成得更快,最终图像可能会在生成完整数量的部分图像之前发送

Required range: 0 <= x <= 3
quality
enum<string> | null
default:auto

图像质量。GPT Image 2.5 支持 auto、low、medium、high、xhigh 和 max;dall-e-2 仅支持 standard

Available options:
auto,
max,
xhigh,
high,
medium,
low,
standard
response_format
enum<string> | null
default:b64_json

平台响应格式。b64_json 直接返回图片 Base64;url 会由平台转存图片并返回签名 URL

Available options:
url,
b64_json
size
enum<string> | null
default:1024x1024

生成图像的尺寸。gpt-image-1 必须是 1024x1024、1536x1024(横向)、1024x1536(纵向)或 auto(默认值)之一。dall-e-2 必须是 256x256、512x512 或 1024x1024 之一

Available options:
1024x1024,
1536x1024,
1024x1536,
auto,
256x256,
512x512
stream
boolean | null
default:false

以流式模式编辑图像。默认为 false。有关更多信息,请参阅图像生成指南

user
string

代表您的最终用户的唯一标识符,可以帮助 OpenAI 监控和检测滥用

Response

图像编辑成功

created
integer<int64>
required

图像创建时的 Unix 时间戳(以秒为单位)

Example:

1677649963

data
object[]
required

生成的图像列表

background
enum<string>

OpenAI 兼容保留字段,上游可能回传实际背景设置。当前 Azure / QNAIGC GPT Image 2.5 适配器不返回

Available options:
transparent,
opaque,
auto
output_format
enum<string>

OpenAI 兼容保留字段,上游可能回传实际图片格式。当前 Azure / QNAIGC GPT Image 2.5 适配器不返回

Available options:
png,
webp,
jpeg
quality
enum<string>

OpenAI 兼容保留字段,上游可能回传实际质量档位。当前 Azure / QNAIGC GPT Image 2.5 适配器不返回

Available options:
low,
medium,
high,
xhigh,
max,
auto
size
string

OpenAI 兼容保留字段,上游可能回传实际图片尺寸,例如 1024x1024。当前 Azure / QNAIGC GPT Image 2.5 适配器不返回

usage
object

GPT Image 模型的 token 使用信息。仅在上游提供 usage 时出现

generate_image
integer

平台扩展字段,本次成功生成的图片张数。它不是 token,不应加到 total_tokens

Required range: x >= 0
generate_image_r1
integer

平台扩展字段,R1 分辨率计费档位的图片张数;仅部分按张或档位计费的模型返回

Required range: x >= 0
generate_image_r2
integer

平台扩展字段,R2 分辨率计费档位的图片张数;仅部分按张或档位计费的模型返回

Required range: x >= 0