图片 / GPT 4K 与重建

Image 2.0 2K (Medium)

按张计费的 GPT Image 2 / 2.5 Flare / Sunburst 分组，三个模型同价 $0.045。分组说明为仅支持 2K、quality=medium，服务可能出现波动，建议配置备用渠道。走 OpenAI Images 接口，文生图和参考图编辑写法与全参 4K 分组相同。

分组 #127「【GPT 生图】Image 2.0 2K (Medium)」 · Key 需属于该分组

文生图图生图2Kquality=medium多参考图URL 返回Base64 返回

价格—

24 小时成功率—

可用模型

`POST /v1/images/generations`	文生图，JSON
`POST /v1/images/edits`	图生图：JSON images[].image_url，或 multipart 重复上传 image
`GET /v1/models`	用同一把 Key 查询当前分组可用的完整模型名

计费方式	按张 $0.045，三个模型同价（分组倍率 1）
分辨率 / 质量	分组说明：仅支持 2K、quality=medium
参考图上限（2026-09-15 旧实测）	gpt-image-2 最多 10 张（11 张返回 400）；flare 已验证到 6 张；sunburst 最多 6 张（7 张返回 400）
multipart 文件	每个文件严格小于 20 MiB，整包还受网关和上游限制
n	推荐数字 1；gpt-image-2 的 n=2 实测返回两张，flare / sunburst 的 n=2 返回 502
返回格式	b64_json 或 url（均已验证），URL 有效期未验证
超时建议	出图常需 1 分钟以上，客户端超时不少于 300 秒

字段	类型		说明
`model`	string	必填	完整模型名，见上方模型列表
`prompt`	string	必填	描述编辑目的，多图时说明图1、图2 的用途
`images`	array	可选	图生图（JSON）必填：对象数组，每项 {"image_url": URL 或 Data URL}
`image`	file	可选	图生图（multipart）：重复上传同名字段；JSON 顶层 image 不是同一种写法
`size`	string	可选	宽x高；横竖方向有效，实际像素不保证等于请求值
`aspect_ratio`	string	可选	旧实测只测过省略 size 时传 "9:16"，与 size 冲突时的优先级未测
`quality`	string	可选	推荐 medium（分组说明仅支持 medium）
`n`	integer	可选	推荐数字 1；字符串 "1" 返回 400
`response_format`	string	可选	b64_json 或 url
`output_format`	string	可选	可选 jpeg；gpt-image-2 请求 jpeg 实测仍返回 PNG，flare / sunburst 以文件检测为准

已验证会报 400 的 JSON：images: []、images: ["URL"]、顶层 image、images[].file_id、字符串 n: "1"。
JSON 参考图的 Base64 必须带 data:image/png;base64,（或 jpeg / webp）前缀；URL 必须能直接下载图片。
HTTP 200 只表示请求成功，不表示所有附带字段都已生效；交付前读取实际文件格式和宽高。
seed、mask、background、output_compression、moderation、input_fidelity、style、partial_images、流式响应和 output_format=webp 不在已确认支持范围内。
文件扩展名按实际图片编码确定，gpt-image-2 的 jpeg 参数实测仍返回 PNG。
超时后先检查用量记录，避免重复提交。

返回	原因与处理
`401 / 403`	Key 错误、已禁用或未绑定该分组；检查 Authorization: Bearer 请求头、绑定分组和访问权限。
`503 No available compatible accounts`	该分组账号暂时全部繁忙或在冷却；稍后重试，或换用同模型的其他分组。
`429 Upstream rate limit exceeded, please retry later`	上游限流；按指数退避重试，并降低并发。
`400 poll failed: … "image_unsafe" … The generated images appear to be unsafe…`	触发内容安全审核；修改描述或更换参考图后重试。
`400（参考图超限）`	gpt-image-2 超过 10 张、sunburst 超过 6 张时返回 400；减少参考图。
`502 Upstream access forbidden · Upstream service temporarily unavailable`	上游短暂故障；稍后重试，先在使用记录确认没有成功结果，避免重复生成。
`499（连接已断开，无返回内容）`	客户端在出图前断开了连接；出图常需 1 分钟以上，客户端超时不少于 300 秒。