GPT Image 2

概览

GPT Image 2 是 OpenAI 推出的最新图像生成模型，针对高分辨率输出、灵活宽高比和分档质量进行了优化。同时支持文生图与图生图（image-to-image）并可传入多张参考图。

最适合：营销创意、超宽屏 / 竖版构图、自定义分辨率出图，以及对清晰度有要求的产品图。

生产环境请保留兜底模型。 近期 gpt-image-2 调用量较大，OpenAI 上游偶有不稳定，可能出现响应变慢或偶发错误。生产流量建议同时保留一个 Gemini 模型（优先推荐 gemini-3-pro-image-preview，成本敏感场景可选 gemini-3.1-flash-image-preview）作为兜底方案。

能力概览

功能	支持情况
文本生成图片	✅ 支持
图片编辑（图生图）	✅ 支持（仅 URL，不接受 base64）
批量生成	⚠️ 目前仅支持 `n=1`
自定义分辨率	✅ 长边最高 3840
质量分级	✅ `low` · `medium` · `high` · `auto`

定价

按输出尺寸 × 画质计费的积分矩阵（每张）。quality=auto 与 high 同价。

规格	最长边	`low`	`medium`	`high` / `auto`
1K	≤ 1536 px	1	4	14
2K	≤ 2048 px	2	17	67
4K	≤ 3840 px	4	34	133

价格说明： medium / high 档位约为 OpenAI 官方 API 价格的 8 折（来源）。low 档因最低 1 credit 粒度，按 最低收费 1 credit / 张 计费，可能高于 8 折。请求中 size=auto 默认按 1K 档计算；quality=auto 等同 high。最终扣费 = 矩阵值 × n。

计费示例

请求	档位	画质	积分 / 张
`size: "auto"`, `quality: "auto"`（默认）	1K	high	14
`size: "1024x1024"`, `quality: "low"`	1K	low	1
`size: "1536x1024"`, `quality: "medium"`	1K	medium	4
`size: "2048x1152"`, `quality: "high"`	2K	high	67
`size: "3840x2160"`, `quality: "high"`	4K	high	133

支持的尺寸

可以传入预设尺寸，也可以使用完全自定义的 WIDTHxHEIGHT。

常用预设

1024x1024 · 1536x1024 · 1024x1536 · 2048x2048 · 2048x1152 · 3840x2160 · 2160x3840 · auto

自定义尺寸

自定义 WIDTHxHEIGHT 必须同时满足以下约束：

长边不超过 3840 像素
宽和高都必须是 16 的倍数
宽高比不得超过 3:1（长边 ≤ 3 × 短边）
总像素数在 655,360 到 8,294,400 之间

不传 size 或设置为 auto 时，由模型自动选择最合适的尺寸。

质量选项

取值	说明
`low`	速度最快，细节最少
`medium`	速度与质量平衡
`high`	最高细节与还原度
`auto`	由模型自动选择（默认）

快速开始

将 YOUR_API_KEY 替换为你自己的 API Key。还没有？在此创建。

curl -X POST "https://api.nanobananaapi.dev/v1/images/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫戴着橙色围巾抱着水獭，温暖插画风格",
    "n": 1,
    "size": "3840x2160",
    "quality": "high"
  }'

const res = await fetch('https://api.nanobananaapi.dev/v1/images/generate', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: '一只橘猫戴着橙色围巾抱着水獭，温暖插画风格',
    n: 1,
    size: '3840x2160',
    quality: 'high',
  }),
});

const result = await res.json();
console.log(result.data.url);

import requests

res = requests.post(
  'https://api.nanobananaapi.dev/v1/images/generate',
  headers={
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  json={
    'model': 'gpt-image-2',
    'prompt': '一只橘猫戴着橙色围巾抱着水獭，温暖插画风格',
    'n': 1,
    'size': '3840x2160',
    'quality': 'high',
  },
  timeout=60,
)

result = res.json()
print(result['data']['url'])

API 参数参考

参数	类型	必填	说明
`model`	string	是	必须为 `gpt-image-2`
`prompt`	string	是	文本描述，最长 2000 字符
`image`	string \| string[]	仅编辑时	参考图的公开 URL或 URL 数组。`gpt-image-2` 不支持 base64 / `data:` URL，需先上传到 CDN 后传 URL。最多 14 张。
`n`	integer	否	生成数量。目前仅支持 `1`（默认 `1`），`n > 1` 的请求会被拒绝；如需多张请多次调用 API。
`size`	string	否	预设值、自定义 `WIDTHxHEIGHT` 或 `auto`（默认 `auto`）
`quality`	string	否	`low` · `medium` · `high` · `auto`（默认 `auto`）

图片编辑（图生图）

需要基于参考图进行编辑或合成时，请调用 /v1/images/edit（或 OpenAI 兼容接口 /api/v1/images/edits），并在 image 字段中传入一个或多个公开 URL。gpt-image-2 不接受 base64 / data: URL。

curl -X POST "https://api.nanobananaapi.dev/v1/images/edit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "将背景替换为日落下的雪山，保留主体",
    "image": "https://cdn.example.com/source.png",
    "n": 1,
    "size": "auto",
    "quality": "high"
  }'

const res = await fetch('https://api.nanobananaapi.dev/v1/images/edit', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: '将这两个产品置于纯净棚拍背景',
    image: [
      'https://cdn.example.com/product-a.png',
      'https://cdn.example.com/product-b.png',
    ],
    n: 1,
    size: '2048x1152',
    quality: 'high',
  }),
});
const result = await res.json();
console.log(result.data.url);

最佳实践

优先使用 auto：让模型自动选择尺寸和质量，再针对性微调。
自定义尺寸：尽量贴近常用预设并保证为 16 的倍数，可避免被拒。
宽高比限制：超宽 Banner 请保持比例 ≤ 3:1（例如 3072x1024，而不是 3840x1024）。
提示词长度：不超过 2000 字符，简洁的提示通常能得到更清晰的结果。

常见问题

gpt-image-2 支持图片编辑吗？ 支持。调用 /v1/images/edit，在 image 字段中传入公开 URL（或 URL 数组）即可。注意 gpt-image-2 不支持 base64 / data: URL，需先将图片上传到 CDN 后传 URL。

为什么我的自定义尺寸被拒绝？ 最常见的原因：宽或高不是 16 的倍数、长边超过 3840、宽高比超过 3:1、总像素数超出 655,360–8,294,400 范围。

积分是怎么计算的？ 按「尺寸档（1K / 2K / 4K，根据最长边推断）」×「画质（low / medium / high，auto 与 high 同价）」查表扣费，详见上面的定价表格。最终扣费 = 矩阵值 × n。所有积分均为 OpenAI 官方 API 价格的 8 折。