跳转到主要内容
POST

授权

Authorization
string
header
必填

Bearer YOUR_API_KEY。在 API Keys 管理密钥。

请求体

application/json
model
string
必填

兼容旧别名 openai/gpt-image-2。

Allowed value: "gpt-image-2"
prompt
string
必填

生成或编辑提示词。

Required string length: 1 - 32000
images
object[]

参考图;省略或传空数组为文生图。

Maximum array length: 6
resolution
enum<string>
默认值:1K

输出清晰度。

可用选项:
1K,
2K,
4K
aspect_ratio
enum<string>
默认值:1:1

输出宽高比。

可用选项:
1:1,
3:2,
2:3,
16:9,
9:16,
4:3,
3:4,
21:9,
9:21
num
integer
默认值:1

输出数量。

必填范围: 1 <= x <= 4
quality
enum<string>
默认值:medium

画质档位。

可用选项:
low,
medium,
high
background
enum<string>

背景偏好。

可用选项:
auto,
opaque,
transparent

响应

任务已受理。

task_id
string
必填

任务 ID,用于轮询。

model
string
必填

回显提交的模型 ID 或旧别名。

created_at
string<date-time>
必填

任务创建时间(UTC)。

request_id
string
必填

请求 ID。