Skip to content
AI Blog

Nano Banana API 与 AI Studio 入门

最后更新：2026-08-21· 17 分钟阅读

🚀 快速通道

  • Nano Banana 2 国内版：点击直达↗
  • 文生图工作台：打开镜像↗
  • 官方 Gemini：gemini.google.com ↗

Nano Banana API 与 AI Studio 入门

更新时间：2026-08-21。端点、模型 ID、配额与价格以 Gemini API 图像文档 与 Google AI 控制台当日内容为准；下文不写死易过期单价与限流数字。

导读

「Nano Banana API」「Gemini API 出图」对应的是把图像生成接到网站、设计流水线或内部工具。可上线的接入不只是「跑通一次生成」，还要管：密钥不进前端、模型 ID 可配置、失败可重试、用量可观测、输出可审核。 网页 Gemini 适合探索；产品集成走服务端 API，并用 AI Studio 做提示与型号预演。

这篇解决什么问题？

  • 分清 App 体验、AI Studio、正式 API 三条路径
  • 正确对待产品名（Nano Banana 2 / 2 Lite / Pro）与文档中的模型 ID
  • 建立密钥、日志脱敏与成本告警的最低安全基线
  • 上线前用检查清单验收，而不是只看一张样图

App ≠ AI Studio ≠ API

路径适合做什么不适合做什么
Gemini App快速试构图、改图对话高并发生产、密钥托管
AI Studio调提示、对比型号、导出示例把个人 Key 写进公开仓库
Gemini API服务端自动化、产品功能在浏览器暴露 Key

国内用户若先走第三方网页入口，请记住：第三方 ≠ Google 官方，账号与账单体系可能完全分离。访问路径见 国内使用指南。

模型 ID：产品名与文档名不要混用

对外沟通可用 Nano Banana 2、Nano Banana 2 Lite、Nano Banana Pro；写进代码时，以文档列出的 model code 为准（例如文档中的 Flash Image / Flash Lite Image / Pro Image 系列）。列表会更新，教程禁止把某一天的字符串当永久真理。

选型速记（细节见专题文）：

配置建议：模型名放环境变量或远程配置，发版不必改代码。

推荐落地顺序

  1. 在 AI Studio 用同一提示跑通目标型号，保存成功参数。
  2. 阅读官方图像生成文档：鉴权方式、响应里如何取图像、安全过滤说明。
  3. 在服务端用官方 SDK 或 HTTPS 调用；本地用环境变量注入 Key。
  4. 为「生成成功 / 安全拦截 / 超时 / 配额」分类打日志（禁止记录完整 Key）。
  5. 加预算告警与每用户速率限制，避免提示词被刷爆账单。
# 本地开发示例（名称以你项目约定为准）
export GEMINI_API_KEY="your-secret-here"
export NANOBANANA_MODEL="/* 从文档复制当日 model id */"
$env:GEMINI_API_KEY = "your-secret-here"
$env:NANOBANANA_MODEL = "/* 从文档复制当日 model id */"

硬性规则： Key 只出现在服务端密钥系统；不要写进前端包、Git、截图或共享表格。泄露后立即轮换。

成本与质量可观测

记录每次调用的：模型 ID、分辨率档位、是否带参考图、延迟、是否被安全策略拦截、人工是否采用。
这样你才能回答「Lite 草稿节省了多少」「2 成稿通过率多少」，而不是凭感觉选型。提示词版本也要编号，方法见 提示词指南。

自动化流水线常见模式：Lite 批量出候选 → 人工或规则初筛 → 2/Pro 精修 → 设计工具叠字与导出。入门操作见 新手入门。

完成检查清单

  • 已确认使用的是文档中的当前模型 ID（可配置）
  • API Key 仅存服务端，仓库无密钥
  • 超时、重试、错误分类已实现
  • 日志无 Key、无未脱敏用户图
  • 用量/预算告警已打开（若控制台提供）
  • 输出有人工或自动审核闸门再对终端用户展示
  • 版权与参考图授权有记录

快速通道 / 访问入口

常见问题

网页里能选的模型，API 一定有吗？

不一定同步。以 API 文档与控制台「可用模型」列表为准；不要假设 App 按钮名等于可调用 ID。

可以在浏览器直连 Gemini API 出图吗？

不推荐。浏览器无法安全持有长期 Key，且容易被盗刷。应通过自有后端代理。

第三方国内站的「API」能当官方用吗？

不能默认等价。协议、日志、模型路由与合规责任都可能不同；正式产品集成优先官方文档路径，并单独评估第三方条款。

价格和 RPM 限流写在哪？

以 Google AI / Gemini API 定价与配额页面的当日数据为准；本教程不复制易过期数字。

官方资源

延伸阅读

总结

Nano Banana 的工程接入，关键是把探索（App / Studio）与生产（服务端 API）分开：模型 ID 可配置、密钥不出前端、成本与拦截可观测、输出经审核再上线。先读官方图像文档核对当日型号，再把提示词与风格卡版本化，流水线才能既快又可控。

相关内容