Skip to main content
POST

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
prompt
string
required

描述所需图像的文本提示。GPT Image 系列最大长度为 32000 个字符，dall-e-2 最大长度为 1000 个字符，dall-e-3 最大长度为 4000 个字符

Maximum string length: 32000
Example:

"一只可爱的小猫在花园里玩耍，阳光明媚，油画风格"

​
model
enum<string> | null
required

用于图像生成的模型。新接入推荐 gpt-image-2.5-flare（速度优先）或 gpt-image-2.5-sunburst（编辑精度优先）

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,
dall-e-3
Example:

"gpt-image-2.5-flare"

​
background
enum<string> | null
default:auto

设置生成图像背景。GPT Image 2.5 支持 transparent、opaque 或 auto；transparent 请配合 png 输出格式

Available options:
transparent,
opaque,
auto
​
moderation
enum<string> | null
default:auto

控制 gpt-image-1 生成图像的内容审核级别。必须是 low（较少限制的过滤）或 auto（默认值）

Available options:
low,
auto
​
n
integer | null
default:1

要生成的图像数量。必须在 1 到 10 之间。对于 dall-e-3，仅支持 n=1

Required range: 1 <= x <= 10
Example:

1

​
image

平台扩展的图片编辑输入。可传单个字符串或最多 16 个字符串；每项支持 HTTP(S) URL、纯 Base64 或 data:image/...;base64,... Data URI。传入后平台按图片编辑处理；需要 mask 时请改用 /v1/images/edits

​
output_compression
integer | null
default:100

生成图像的压缩级别（0-100）。GPT Image 2.5 当前平台接入仅在 output_format=jpeg 时使用

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-3 支持 hd 和 standard；dall-e-2 仅支持 standard

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

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

Available options:
url,
b64_json
​
size
enum<string> | null
default:auto

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

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

以流式模式生成图像。默认为 false。有关更多信息，请参阅图像生成指南。此参数仅支持 gpt-image-1

​
style
enum<string> | null
default:vivid

生成图像的风格。此参数仅支持 dall-e-3。必须是 vivid 或 natural 之一。vivid 使模型倾向于生成超现实和戏剧性的图像。natural 使模型产生更自然、不太超现实的图像

Available options:
vivid,
natural
​
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