跳转到主要内容
POST

输出格式

GIF 可在 extra_params 中设置 frame_count 和 frame_duration_ms:
  • frame_count 默认 9;768x768 支持 2–12 帧,其他尺寸支持 2–16 帧。
  • frame_duration_ms 默认 200;范围 20–2000 ms,步长 10 ms。
PNG 图生图省略 aspect_ratio 时按首图预扣;输出升档可能补扣差额。指定 resolution 和固定比例可锁定档位。 提交后查询任务状态。参见模型价格。

授权

Authorization
string
header
必填

Bearer YOUR_API_KEY。在 API Keys 管理密钥。

请求体

application/json
model
string
必填
Allowed value: "gpt-image-2.6-sunburst"
prompt
string
必填

生成或编辑提示词。

Required string length: 1 - 32000
images
object[]

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

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

仅适用于 PNG / SVG。

可用选项:
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>
默认值:high

画质档位。

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

仅适用于 PNG。

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

响应

任务已受理。

task_id
string
必填

任务 ID,用于轮询。

model
string
必填

回显请求中的模型 ID。

created_at
string<date-time>
必填

任务创建时间(UTC)。

request_id
string
必填

请求 ID。