无需付费云项目即可体验 Nano Banana 2。AI Studio 免费层足以进行 UI 测试和生成第一张 API 图像——但在投入生产前请务必了解限制。

UI 路径（两分钟）

打开 Google AI Studio 并登录。
模型选择器 → Gemini 3.1 Flash Image（Nano Banana 2 系列）。
提示词：Product photo of a stainless water bottle on white, soft shadow, 4:5。
下载或通过后续编辑进行迭代。

注意速率限制：免费层会限制突发流量；批量任务请移至带计费的 Vertex。

API 路径（开发者）

AI Studio → 获取 API 密钥（切勿提交到 Git）。
使用当前文档中支持图像的 Gemini 模型 ID（例如 gemini-3.1-flash-image-preview——发布前请在 Studio 中验证）。
发送包含文本提示词的多模态 generateContent 请求。

伪代码流程如下：

# 将密钥存入环境变量——切勿放入仓库
export GEMINI_API_KEY="your-key"

你的应用应从环境变量读取密钥，在提示词或配置中设置纵横比，并将二进制图像字节保存到磁盘。

Explore Nano Banana Workflows

从 UI 到 API 通用的提示词技巧

为确保可靠性，每个请求仅包含一个场景。
引用文本字面量。
如果 SDK 缺乏相关旋钮，请用自然语言要求纵横比。

安全性

密钥仅存放在 .env.local 中；一旦泄露立即轮换。MidassAI 站点构建绝不能嵌入密钥——本教程仅适用于本地工具链。

下一步

首次调用成功后，将提示词封装到你的 CMS 或 MidassAI Nano 工作流中，让营销人员无需接触 curl 命令。

前提条件与设置

你需要一个已启用 AI Studio 访问权限的 Google 账户方可继续。标准消费者账户可用于测试，但组织策略可能会阻止外部 API 密钥生成。确保你已安装 VS Code 等代码编辑器，以便在本地机器上安全管理环境变量。

能够运行 curl 命令的终端有助于在集成到大型应用之前验证 API 响应。

假设模型标识符在测试期间保持为 gemini-3.1-flash-image-preview。Google 会频繁更新端点名称，因此请每周检查模型选择器是否有变更。如果你计划自动化生成，请安装最新的 Python SDK 或准备好 HTTP 客户端以进行直接调用。不要依赖已弃用的 v1 端点进行图像生成任务。

扩展提示词工作流

在文本字符串中明确定义光照条件。不要使用“柔和阴影”等模糊术语，而是指定 key light at 45 degrees, fill ratio 1:2 以减少生成之间的差异。
通过自然语言设置分辨率约束。如果此模型版本的 API 配置缺乏明确的尺寸字段，请在提示词中写入 output resolution 1024x1024。
包含负面约束以清理伪影。添加 no text overlays, no watermarks, clean background 以防止需要后期处理的常见渲染错误。
使用种子链接请求以生成变体。发送五个具有不同种子值的相同提示词，以便无需人工干预即可通过编程选择最佳构图。
严格验证输出格式。在尝试解码之前，检查响应 JSON 中是否包含含 base64 图像字符串的 inlineData，以避免脚本因空响应而崩溃。

常见错误

在脚本中硬编码凭据： 开发者为了速度经常将密钥直接粘贴到源文件中。解决方法是使用 .env 文件并通过 python-dotenv 等库加载，以永久将机密信息排除在版本控制系统之外。
忽略速率限制标头： 测试期间达到阈值后，免费层会静默拒绝请求。解决方法是在收到服务器返回的 429 状态码时，在重试机制中实施指数退避逻辑。
单个提示词过载： 一次性请求包含多个主体的复杂场景经常失败。解决方法是使用标准图像编辑工具将复杂图像分解为单独的生成调用，然后再进行合成。

在 MidassAI 中尝试

若要获得无需处理原始 API 密钥的托管体验，请直接使用 MidassAI 界面。它将 Nano Banana 2 功能封装到可视化工作流构建器中，允许你测试提示词并保存迭代，无需编写样板代码或管理安全凭据。直接在 https://www.midassai.com/studio/nano/ 开始构建你的图像生成管道，以简化生产部署并集成到现有的营销工具中。

Nano Banana 2 实战：AI Studio 免费层调用 API 生成图像