跳转到主要内容
POST

授权

Authorization
string
header
必填

Bearer YOUR_API_KEY。在 API Keys 管理密钥。

请求体

application/json
model
string
必填
Allowed value: "gpt-image-2.5-flare"
prompt
string
必填

生成或编辑提示词。

Required string length: 1 - 32000
images
object[]

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

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

输出清晰度。

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

PNG 图生图省略时适配首张参考图。

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

输出数量。

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

画质档位。

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

背景偏好。

可用选项:
auto,
opaque,
transparent
extra_params
object

响应

任务已受理。

task_id
string
必填

任务 ID,用于轮询。

model
string
必填

回显请求中的模型 ID。

created_at
string<date-time>
必填

任务创建时间(UTC)。

request_id
string
必填

请求 ID。