Skip to main content
POST
gpt-image-2.5-sunburst 生成图像 API

gpt-image-2.5-sunburst 生成图像 API

gpt-image-2.5-sunburst 使用与 gpt-image-2gpt-image-2-pro 一致的 JSON 请求格式提交图像生成请求,支持全部基础、2K4K 尺寸档位。
  • 请求路径为 POST /v1/images/generations
  • 通过 model = "gpt-image-2.5-sunburst" 选择目标模型。
  • prompt 描述要生成的图像内容。
  • size 支持 gpt-image-2gpt-image-2-pro 的全部尺寸;请求时传实际 WxH 尺寸。
  • quality 支持 lowmediumhighxhighmaxauto
  • 支持 urlb64_json 两种返回格式。
  • 可在 JSON 中附带 image 作为参考图。
  • n 不传或显式传 0 时会按 1 处理。

方法与路径

请求示例

响应示例

认证

Body

string
required
固定传 gpt-image-2.5-sunburst
string
required
生成提示词,用于描述想要生成的图片。
integer
生成数量。若不传或显式传 0,按 1 处理。
string
输出尺寸。支持全部尺寸档位:基础尺寸 1024x10241536x11521536x10241024x15361920x10801080x1920,以及 2K / 4K 尺寸表中的全部实际 WxH 值。
string | array<string> | object
可选参考图输入。常见写法是 Base64 字符串或 Base64 数组。
string
返回格式,常见值为 urlb64_json
string
质量等级。支持 lowmediumhighxhighmaxauto;是否真正生效取决于最终命中的渠道。
string | object
风格字段,原样透传给支持的上游。
string | object
背景控制字段,原样透传给支持的上游。
boolean
显式水印开关。false 与不传语义不同。

尺寸表

gpt-image-2.5-flaregpt-image-2.5-sunburst 均支持以下全部尺寸。请求体中的 size 传“实际目标尺寸”一列。

基础尺寸

2K 档位

4K 档位

Response

integer
生成时间戳。
string
response_format = url 时返回的图片 URL。
string
response_format = b64_json 时返回的图片 Base64 数据。
string
部分上游会改写提示词并返回在这个字段里。

异步调用

如需提交后异步查询结果,可以使用图像异步生成入口:
异步请求仍传 model = "gpt-image-2.5-sunburst"size 可使用本页列出的全部尺寸。提交成功后读取返回的 id / task_id,再通过 GET /v1/images/generations/async/{taskId} 查询状态和结果。

相关页面