生图模型

gpt-image-2.5-sunburst

images · /v1/images/generations

型号与端点

模型 ID：gpt-image-2.5-sunburst，请求中使用完整名称。

协议：images。端点：POST /v1/images/generations。

输入：text、reference_image。输出：image。

认证、完整字段和响应格式见 images。调用前请确认 Key 已开通此型号。

请求示例

json

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "白色桌面上的蓝色陶瓷杯，无文字",
  "size": "1024x1024",
  "quality": "medium",
  "output_format": "png",
  "n": 1
}

以上为请求体示例，地址和请求头见协议页。其他可选字段请查阅对应参数说明。

参数与输入

文生图发送 JSON，参考图编辑上传 multipart 文件。编辑路径为 /v1/images/edits?api-version=2025-04-01-preview。质量、格式、尺寸及蒙版参数按 Images API 中的对应型号设置。

附件格式：参考图 PNG/JPEG/WebP；mask PNG Alpha；输出 PNG/JPEG。编码：生成 JSON；编辑 multipart image / image[] / mask。

官方限制：gpt-image-2: 参考图 1–16 张且 <50 MB/张；mask <4 MB。

上传说明：总请求需符合网关限制；mask 与首图同宽高，返回图片需解码并核对尺寸。其他限制：不支持文件理解、视频或 Chat/Responses 生图字段。完整规格见模型输入规格表。

响应处理

检查错误正文与 data 数组，逐张解码图片，核对格式、尺寸和参考图对应关系。HTTP 200 后仍需完成这些检查。文件大小及格式要求见文件与媒体输入。