Skip to main content
POST

Authorizations

Authorization
string
header
required

API Key 通过 Authorization: Bearer <key> 传入。

Body

application/json
prompt
string
required

所需图像的文本描述。

Maximum string length: 32000
model
enum<string>
default:gpt-image-2-official
Available options:
gpt-image-2-official
n
integer
default:1

生成图像数量。

Required range: 1 <= x <= 10
size
string
default:auto

输出尺寸。预设:1024x10241536x10241024x1536auto。也支持任意 宽x高:宽高均被 16 整除、宽高比在 1:3 ~ 3:1 之间、且不超过模型上限(最大 3840x2160)。

Examples:

"auto"

"1024x1024"

"1536x1024"

"1024x1536"

"1536x864"

quality
enum<string>
default:auto

渲染质量。

Available options:
low,
medium,
high,
auto
background
enum<string>
default:auto

背景处理。暂不支持透明背景。

Available options:
opaque,
auto
output_format
enum<string>
default:png

输出图像格式。

Available options:
png,
jpeg
output_compression
integer
default:100

压缩级别(0-100%),对 jpeg 输出生效。

Required range: 0 <= x <= 100
moderation
enum<string>
default:auto

内容审核强度。

Available options:
low,
auto
user
string

用于滥用监测的终端用户标识。

Response

生成的图像。

created
integer
required

Unix 时间戳(秒)。

data
object[]
required
background
enum<string>
Available options:
opaque
output_format
enum<string>
Available options:
png,
jpeg
quality
enum<string>
Available options:
low,
medium,
high
size
string

实际渲染尺寸,如 1024x1024

usage
object