Gemini 3 Pro Image API（原 Preview）：定价、分辨率与调用实战指南

Gemini 3 Pro Image API（原 Preview）——即社区熟知的 Nano Banana Pro，是目前 Google Gemini 视觉模型矩阵中生成质量最出色的图像模型。在很多开发团队从早期的原型验证走向正式商业化交付时，它往往成为生产环境的标配。

本文将从第一方 API 运营团队的视角，系统梳理 Gemini 3 Pro 官方 GA 演进、Pixapi 兼容别名、长宽比与分辨率参数规范，以及真实调用价格核算。

什么是 Gemini 3 Pro Image？

Gemini 3 Pro Image 是 Google 推出的专业级图像生成与二次编辑模型。它同时支持文生图（Text-to-Image）与图生图（Image-to-Image/Edits），原生支持最高 4096×4096 (4K) 分辨率输出，尤其擅长在保持原图主体构图的前提下进行逼真的照片级局部修改。

关于该模型的命名演进与兼容性：

1. Google 官方命名与 GA 演进：Google 官方在早期测试阶段使用了 gemini-3-pro-image-preview，随着模型正式推向 GA（常规可用），官方规范命名现为 gemini-3-pro-image。
2. Pixapi 兼容路由支持：为了让开发者的存量集成平滑运行，Pixapi 优先支持官方生产 ID gemini-3-pro-image，同时向下兼容经典的旧别名 gemini-3-pro-image-preview。
3. Nano Banana Pro 社区别称：Nano Banana Pro 是技术社区对 Gemini 3 Pro Image 的普遍代称。

Gemini 3 Pro Image API 价格明细

Pixapi 平台使用透明的 Credit 体系计费（1 credit = $0.01），美元金额与点数一一对应：

价格核实于 2026 年 8 月。2K 输出与 1K 保持同价（$0.08），而 4K 官方标准价现约为 $0.24，在 Pixapi 上以 $0.16 即可获得高质量的渲染输出。详细点数充值档位可在 价格页面 查阅。

同时，Pixapi 还提供 Gemini 图像家族的全梯度支持：

API 快速接入与代码示例

在 Pixapi 控制台 获取 Bearer API Key 后，即可通过标准 REST 端点发起调用。请注意：size 参数用于设置长宽比（如 1:1、16:9、9:16、4:3），分辨率（1K/2K/4K）通过模型 ID 对应档位触发。

1. 文生图（Text-to-Image）调用示例：生成 2K 正方形图像

curl -X POST https://api.pixapi.ai/v1/images/generations \
  -H "Authorization: Bearer $PIXAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-2k",
    "prompt": "Studio product photo of a ceramic coffee mug on linen, soft daylight",
    "size": "1:1"
  }'

2. 图像编辑与局部重绘（Image Edits）示例

对于以图生图或局部修改，建议调用专门的 edits 端点并传入参考图 URL：

curl -X POST https://api.pixapi.ai/v1/images/edits \
  -H "Authorization: Bearer $PIXAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "image": "https://example.com/input.jpg",
    "prompt": "Replace the background with a marble countertop, keep the mug unchanged"
  }'

更多请求参数、长宽比配置与返回格式详见 图像生成 API 文档。请注意始终在后端服务端妥善保管 API Key，避免在前端暴露密钥。

Pro 与 Flash 的生产选型策略

在架构设计中评估何时接入 Gemini 3 Pro，以下实践法则已被多条产品线验证有效：

• Pro 档位 ($0.08 / 张)：用于最终交付资产，如商业主图、广告素材、精细特写及包含丰富细节的大图。
• Flash 档位 ($0.04 / 张)：用于高频试错，如多方案预览、交互式草稿生成或速度优先的实时交互应用。
• Flash Lite / 2.5 Flash ($0.02 / 张)：用于轻量化批量任务，如缩略图生成、简易头像转换与海量滤镜处理。

常见且高性价比的组合架构是：前端引导用户使用 Flash 快速生成候选草图，当用户确认选中某一张时，再使用 Pro 进行最终超清渲染，从而兼顾极速体验与顶级画质。

生产环境实战建议

1. 按需配置分辨率 ID：Pixapi 遵循统一规则，推荐基础 ID（如 gemini-3-pro-image）输出 1K，追加 -2k 输出 2K，追加 -4k 输出 4K。
2. 默认请求 2K，按需开启 4K：2K 与 1K 同价（均为 8 积分 = $0.08），相比 1K 清晰度提升显著，是日常性价比最高的生产设置；而 4K 消耗 16 积分，适合精细印刷或大屏展示需求。
3. 结合业务场景设计缓存：对于电商固定品类的生成或标准化滤镜，合理利用缓存可避免重复计费。

延伸阅读与相关资源

• GPT Image 2 vs Nano Banana：哪款图像 API 更适合你？
• Seedance 视频 API 价格与成本测算
• Pixapi 模型目录 与 Nano Banana 专区