Skip to main content
POST
GPT Image 2.5 Sunburst 图像生成

模型选择

主要参数

下表列出常用参数;媒体引用的组合限制以接口校验结果为准。

尺寸对照

size 为比例时,下表给出不同 resolution 对应的输出像素: 精确像素格式如 1600x1200:宽高均为 16 的倍数、单边不超过 3840、长短边比不超过 3:1、总像素介于 655360 与 8294400 之间。此时 resolution 不决定输出尺寸。

返回说明

成功时返回 data[].url。如返回 504 与 task_id,请先查询原任务,不要直接重复提交。

授权

Authorization
string
header
必填

本项目签发的 API 密钥,不是上游密钥

请求体

application/json
model
enum<string>
必填

模型 ID

可用选项:
gpt-image-2.5-sunburst
prompt
string
必填

图片生成或编辑的文字描述;必填

Minimum string length: 1
size
string
默认值:auto

auto、比例(1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21、3:1、1:3),或精确像素(如 1600x1200);图生图建议省略

resolution
enum<string>
默认值:1k

分辨率档位;精确像素尺寸会覆盖此档位

可用选项:
1k,
2k,
4k
quality
enum<string>
默认值:low

图像质量;在本网关中 auto 会按 low 处理

可用选项:
low,
medium,
high,
xhigh,
max,
auto
n
integer
默认值:1

生成张数;必须是数字

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

图像文件格式

可用选项:
png,
jpeg,
webp
output_compression
integer

JPEG 或 WebP 压缩强度

必填范围: 0 <= x <= 100
background
enum<string>

透明背景仅适用于 PNG 或 WebP

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

内容审核强度

可用选项:
auto,
low
image_urls
string[]

图片编辑参考图;最多 16 张,须为公开可访问的 HTTP(S) 地址

Maximum array length: 16
mask_url
string

局部编辑蒙版;需与第一张参考图同尺寸、带 Alpha 通道的 PNG,可使用公开 URL 或 Data URI

response_format
enum<string>

本网关仅支持 url 响应格式

可用选项:
url

响应

生成成功,返回图片 URL

created
integer
data
object[]