Gemini 3 Pro Image Preview (Nano Banana Pro)

gemini-3-pro-image-preview 是面向高质量生成和编辑的 Gemini 图片模型。nano-banana-pro 是同一模型协议的别名。标准、2K 与 4K 输出都通过 size 字段请求，不再拆成独立模型 id 展示。

API 形式

操作	Endpoint	模式
图片生成	`POST /v1/images/generations`	同步
图片生成任务	`POST /v1/async/images/generations`	异步
图片编辑	`POST /v1/images/edits`	同步
图片编辑任务	`POST /v1/async/images/edits`	异步

价格

积分

模型 id	分辨率	每张积分
`gemini-3-pro-image-preview`	1K（1024px）	8
`gemini-3-pro-image-preview-2k`	2K（2048px）	8
`gemini-3-pro-image-preview-4k`	4K（4096px）	16

请求字段

该模型与 Pixapi 其他图片模型一样，使用 OpenAI 兼容图片字段。

字段	类型	必填	说明
`model`	string	是	使用 `gemini-3-pro-image-preview` 或别名 `nano-banana-pro`。
`prompt`	string	是	描述要生成或编辑的图片。
`image`	file 或 file[]	编辑必填	调用 `/v1/images/edits` 编辑输入图片时通过表单上传。
`n`	number	否	返回图片数量。
`size`	string	否	输出尺寸，例如 `1024x1024`、`2048x1152`、`3840x2160`，或模型支持的其他尺寸。
`response_format`	string	否	模型支持时可选 `url` 或 `b64_json`。

示例

json

{
  "model": "gemini-3-pro-image-preview",
  "prompt": "A premium product photo with natural lighting and precise composition",
  "n": 1,
  "size": "1024x1024"
}

共享响应结构和图片编辑上传示例见 API 参考。