支持模型与参数图片模型
GPT Image 2
gpt-image-2 的参数说明、枚举、示例和接入建议。
gpt-image-2 是当前最适合作为默认入口的公开图片模型,既适合联调验证,也适合正式生产使用。
它的优势是通用性更强,宽高比和分辨率可选项也更丰富。
模型速览
| 项 | 说明 |
|---|---|
| 模型 ID | gpt-image-2 |
| 类型 | 图片 |
| 区域 | Global / CN |
| 推荐场景 | 通用图片生成、海报、封面、编辑 |
| 推荐优先级 | 高,默认优先从它开始 |
推荐请求写法
图片任务统一提交到 POST /v1/generations,这里只需要换 model 值。
{
"model": "gpt-image-2",
"prompt": "A premium skincare poster on warm marble, soft daylight, luxury editorial style",
"aspect_ratio": "4:5",
"resolution": "2K",
"n": 1
}字段说明
| 字段 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | - | 固定传 gpt-image-2 |
prompt | string | 是 | - | 图片描述 |
reference_images | string[] | 否 | - | 参考图 URL 列表 |
aspect_ratio | string | 否 | auto | 输出宽高比 |
resolution | string | 否 | 1K | 输出分辨率 |
n | integer | 否 | 1 | 生成数量 |
可选枚举
| 字段 | 支持值 |
|---|---|
aspect_ratio | auto 1:1 5:4 9:16 21:9 16:9 3:2 4:3 4:5 3:4 2:3 |
resolution | 1K 2K 4K |
gpt-image-2 接入建议
- 如果只是想先验证创建任务、轮询和 webhook 整条链路,这个模型最适合优先测试。
- 它支持
5:4和4:5,这一点比 Banana 系列更灵活。 - 如果只是低成本联调,先从
resolution=1K开始更稳。
最小示例
{
"model": "gpt-image-2",
"prompt": "A premium skincare poster on warm marble"
}
