Skip to main content
POST
生成图片

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model
enum<string>
必填

必须为 gpt-image-2。

可用选项:
gpt-image-2
示例:

"gpt-image-2"

prompt
string
必填

目标图片的文本描述。

示例:

"一只坐在黄昏雪林里的红狐,写实风格"

n
integer
默认值:1

生成图片数量。

必填范围: 1 <= x <= 10
size
string

{width}x{height} 格式。边长须为 16 的倍数,宽高比 ≤ 3:1,总像素 655,360–8,294,400,最长边 3,840px。不传则由模型自行选择(约 130 万像素)。

示例:

"1536x1024"

quality
enum<string>
默认值:low

渲染质量。

可用选项:
low,
medium,
high,
auto
background
enum<string>
默认值:opaque

背景处理方式。使用 transparent 时建议输出 png。

可用选项:
opaque,
transparent,
auto
output_format
enum<string>
默认值:png

输出图片格式,不支持 webp。

可用选项:
png,
jpeg
output_compression
integer

jpeg 输出的压缩级别。

必填范围: 0 <= x <= 100
moderation
enum<string>
默认值:auto

内容审核严格程度。

可用选项:
auto,
low
stream
boolean
默认值:false

是否以 SSE 推送中间帧。

partial_images
integer

stream 为 true 时请求的预览帧数量。

响应

图片生成成功

created
integer

生成时间的 Unix 时间戳。

background
string

实际使用的背景处理方式。

output_format
string

返回图片的格式。

quality
string

实际使用的质量档位。

size
string

实际使用的分辨率。

data
object[]
usage
object