GPT-Image
OpenAI 的四个图片模型、宽高比的默认规则，以及为什么只有 GPT-Image-2 Pro 会遵循 quality。
GPT-Image 是 ListenHub 上 OpenAI 的图片模型系列，gpt-image-2 是整个模型目录的默认模型——省略
model 时拿到的就是它。四个模型都走共用的图片接口。接口本身、请求 schema、异步流程和错误码请看
图片生成总览，本页只讲 GPT-Image 的专属
部分。
模型
| 模型 | 显示名称 | 适用场景 |
|---|---|---|
gpt-image-2 (默认) | GPT-Image-2 | 提示词遵循能力强，按尺寸固定计价 |
gpt-image-2.5-flare | GPT-Image-2.5 Flare | 另一种视觉风格，价格与限制相同 |
gpt-image-2.5-sunburst | GPT-Image-2.5 Sunburst | 第三种风格，价格与限制相同 |
gpt-image-2-official | GPT-Image-2 Pro | 唯一会遵循 quality 的模型；按 token 计价 |
四个模型都使用 provider: "openai"。Flare 和 Sunburst 的计价与限制与 gpt-image-2 完全一致——
在这三者之间选择，改变的是输出的观感，而不是成本或限制。
限制
| 限制项 | gpt-image-2、…-2.5-flare、…-2.5-sunburst | gpt-image-2-official |
|---|---|---|
| 图片尺寸 | 1K、2K、4K | 1K、2K、4K |
| 宽高比 | 10 种标准比例 | 10 种标准比例 |
| 默认宽高比 | schema 默认 1:1（见下文） | schema 默认 1:1（见下文） |
| 参考图 | 最多 4 张 | 最多 4 张 |
quality | 忽略 | low、medium、high |
| 订阅门槛 | 无 | 4K 或 quality: high 需要订阅 |
GPT-Image 是唯一一个校验器从不替你替换比例的系列——但请求 schema 会。imageConfig.aspectRatio
的默认值是 1:1，所以只有省略整个 imageConfig 对象，才能走到模型自己的选择。发送了
imageConfig 却不带 aspectRatio，拿到的就是一张正方形图片。传入极端比例（1:4、4:1、
1:8、8:1）会返回 400，带 code: 26019，消息中给出支持的比例列表。
参考图每次请求上限为 4 张。超出会返回 400，消息为
GPT-Image-2 supports at most 4 reference images。
quality 参数
imageConfig.quality 接受 low、medium 和 high，但只有 gpt-image-2-official
会按请求的质量渲染。
向 gpt-image-2、gpt-image-2.5-flare 或 gpt-image-2.5-sunburst 传 quality
不是错误——该值会被静默丢弃。estimate-credits 会在其 warnings 数组中以警告
quality_ignored_for_gpt_image_2_lite 暴露这一点。如果你的产品里有质量选择器，请读取这个
数组，以免提供一个所选模型会忽略的控件。
计费与订阅门槛
三个 lite 模型按图片尺寸固定积分计价
（pricing.mode 为 fixed，pricingVersion 为 gpt-image-2-lite-fixed-2026-06-15），并且
从不设置 requiresSubscription。
gpt-image-2-official 按预估 token 计价（pricing.mode 为 token-estimate），因此它的成本会
随提示词长度、输出尺寸、请求的质量以及参考图数量变化——在 API 上每张参考图按固定费率计数，因为
OpenAPI 这条路径传的是数量，而不是每张图的尺寸。它也是整个图片模型目录中唯一会设置
requiresSubscription: true 的配置——在 4K 下，或在 quality: high 下。在把这两个选项提供给
没有订阅的账户之前，请先检查预估结果中的这个字段。
gpt-image-2 在 1K 和 2K 上有免费额度资源；Flare 和 Sunburst 共用一个
（gpt-image-2.5）。gpt-image-2-official 在任何尺寸下都没有免费额度。
示例
curl -X POST "https://api.marswave.ai/openapi/v1/images/generation/estimate-credits" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2-official",
"prompt": "A product hero shot of a matte black espresso machine on concrete",
"imageConfig": { "imageSize": "4K", "aspectRatio": "16:9", "quality": "high" }
}'响应中的 requiresSubscription 告诉你这个配置是否需要有效订阅，credits 告诉你它会花多少积分。
完整响应结构见
图片生成总览。