支持模型与参数图片模型
GPT Image 2 Official
gpt-image-2-official 的完整参数、枚举和接入说明。
gpt-image-2-official 是 GPT Image 2 的官方渠道版本，适合需要明确质量档位的图片生成与编辑场景。
它与普通版最重要的参数差异是支持 quality；普通版 gpt-image-2 不应传该字段。
模型速览
| 项 | 说明 |
|---|---|
| 模型 ID | gpt-image-2-official |
| 类型 | 图片 |
| 区域 | Global |
| 推荐场景 | 官方渠道图片生成、质量可控的图片任务 |
| 推荐优先级 | 需要 quality 时优先 |
推荐请求写法
统一提交到 POST /v1/generations，并根据成本与效果选择质量档位。
{
"model": "gpt-image-2-official",
"prompt": "A premium skincare poster on warm marble, luxury editorial style",
"quality": "high",
"resolution": "2K",
"n": 1
}字段说明
| 字段 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | - | 固定传 gpt-image-2-official |
prompt | string | 是 | - | 图片描述 |
reference_images | string[] | 否 | - | 参考图 URL 列表 |
quality | string | 否 | medium | 图片质量档位：low（速度/成本优先）、medium（平衡）、high（质量优先）；档位会影响费用 |
resolution | string | 否 | 1K | 输出分辨率 |
size | string | 否 | - | 上游尺寸字段；仅在明确需要时传入 |
n | integer | 否 | 1 | 生成数量 |
可选枚举
| 字段 | 支持值 |
|---|---|
quality | low（速度/成本优先） medium（默认，质量与成本平衡） high（质量优先，成本更高） |
resolution | 1K 2K 4K |
gpt-image-2-official 接入建议
- 联调时建议从
quality=medium、resolution=1K开始，再按最终效果提升档位。 quality仅属于官方版；切换到gpt-image-2时必须移除该字段。- 生成多张图片时使用
n，报价和最终消耗会按实际生成数量计算。
最小示例
{
"model": "gpt-image-2-official",
"prompt": "A premium skincare poster on warm marble"
}