Nano Banana Pro 开发者全方位教程

@GoogleAIStudio
英语8个月前 · 2025年11月22日
728K
3.6K
588
58
5.0K

TL;DR

这是一份供开发者使用的 Nano Banana Pro(Gemini 3 Pro Image)综合指南,涵盖了通过 Gemini API 实现搜索溯源、4K 分辨率输出以及高级图像混合的详细教程。

了解这款下一代 AI 模型的高级功能——包括思考能力、搜索接地和令人惊叹的 4K 输出——将如何助你构建复杂且富有创意的应用程序。

虽然 Flash 模型(Nano Banana)带来了速度和性价比,但 Pro 版本引入了"思考"能力、搜索接地和高保真 4K 输出。是时候用复杂的创意任务来大显身手了!

本指南将使用 Gemini Developer API 带你了解 Nano Banana Pro 的高级功能。

**本指南将涵盖:

**1. 在 Google AI Studio 中使用 Nano Banana Pro

  1. 项目设置
  2. 初始化客户端
  3. 基础生成(经典玩法)
  4. "思考"过程
  5. 搜索接地
  6. 高分辨率 4K 生成
  7. 多语言能力
  8. 高级图像混合
  9. Pro 专属演示
  10. 最佳实践与提示技巧

注意



:如需获取本文的交互式版本,请查看


Python Cookbook

或 AI Studio 的


JavaScript Notebook

1. 在 Google AI Studio 中使用 Nano Banana Pro

虽然终端用户可以在 Gemini 应用 中访问 Nano Banana Pro,但对于开发者而言,原型设计和测试提示的最佳环境是 Google AI Studio。AI Studio 是一个游乐场,让你在编写任何代码之前可以试验所有可用的 AI 模型,它也是使用 Gemini API 进行构建的入口点。

你可以直接在 AI Studio 中使用 Nano Banana Pro。开始使用时,请访问 aistudio.google.com,使用你的 Google 账号登录,并从模型选择器中选择 Nano Banana Pro(Gemini 3 Pro Image)。

与 Nano Banana 不同,Pro 版本 没有免费层,这意味着你需要选择一个已启用结算功能的 API 密钥(请参阅下面的"项目设置"部分)。

Google AI Studio - inline image

提示



:你也可以直接在 AI Studio 中通过


ai.studio/apps

为 Nano Banana Web 应用编写代码,或者探索代码并重新混搭一个


现有应用

2. 项目设置

要遵循本指南,你需要准备以下内容:

如果你已经是 Gemini API 的重度用户并且已配置好所有内容,那太好了!只需跳过本节,直接进入下一节。否则,请按以下步骤操作:

步骤 A:获取你的 API 密钥

当你首次登录 AI Studio 时,系统应自动为你创建一个 Google Cloud 项目和一个 API 密钥。

打开 API 密钥管理页面,点击"复制"图标来复制你的 API 密钥。

Google AI Studio - inline image

步骤 B:启用结算功能

由于 Nano Banana Pro 没有免费层,你必须在你的 Google Cloud 项目中启用结算功能。

API 密钥管理页面,点击你项目旁边的 设置结算,并按照屏幕上的指示操作。

Google AI Studio - inline image

Nano Banana Pro 的费用是多少?

使用 Nano Banana Pro 生成图像比 Flash 版本更贵,尤其是 4K 图像。在本文发布时,一张 1K 或 2K 图像的费用为 $0.134,而一张 4K 图像的费用为 $0.24(外加输入和文本输出的 token 费用)。

请查阅文档中的 定价页面 以获取最新详情。

<pro 提示</p>



:为了节省 50% 的生成成本,你可以使用


Batch API

。作为交换,你可能需要等待最多 24 小时才能获取你的图像。

步骤 C:安装 SDK

选择你首选语言的 SDK。

Python:

text
1pip install -U google-genai
2# 安装用于图像处理的 Pillow 库
3pip install Pillow

JavaScript / TypeScript:

text
1npm install @google/genai

注意



:以下示例使用 Python SDK 进行演示。在 JavaScript 中使用 Nano Banana 的等效代码片段已提供在此


JS Notebook

中。

3. 初始化客户端

要使用 Pro 模型,你需要使用 gemini-3-pro-image-preview 模型 ID。

python
1from google import genai
2from google.genai import types
3
4# 初始化客户端
5client = genai.Client(api_key="YOUR_API_KEY")
6
7# 设置模型 ID
8PRO_MODEL_ID = "gemini-3-pro-image-preview"

4. 基础生成(经典玩法)

在我们深入高级功能之前,先来看一个标准的生成过程。你可以通过 response_modalities(获取文本和图像或仅获取图像)和 aspect_ratio 来控制输出。

python
1prompt = "创建一只左眼为绿色、右眼为蓝色的暹罗猫的照片级逼真图像"
2aspect_ratio = "16:9" # "1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9" 或 "21:9"
3
4response = client.models.generate_content(
5 model=PRO_MODEL_ID,
6 contents=prompt,
7 config=types.GenerateContentConfig(
8 response_modalities=['Text', 'Image'], # 或仅使用 ['Image']
9 image_config=types.ImageConfig(
10 aspect_ratio=aspect_ratio,
11 )
12 )
13)
14
15# 显示图像
16for part in response.parts:
17 if image:= part.as_image():
18 image.save("cat.png")
Google AI Studio - inline image

聊天模式也是一个选项(实际上,对于多轮编辑,我推荐使用聊天模式)。请查看第 8 个例子"多语言香蕉"以获取示例。

5. "思考"过程

Nano Banana Pro 不仅仅是绘制图像;它还会进行思考。这意味着它可以在生成图像之前推理你那些最复杂、最曲折的提示。最棒的是?你可以窥探它的大脑!

要启用此功能,请在 thinking_config 中设置 include_thoughts=True。

python
1prompt = "创建一个不寻常但逼真的、可能病毒式传播的图像"
2aspect_ratio = "16:9"
3
4response = client.models.generate_content(
5 model=PRO_MODEL_ID,
6 contents=prompt,
7 config=types.GenerateContentConfig(
8 response_modalities=['Text', 'Image'],
9 image_config=types.ImageConfig(
10 aspect_ratio=aspect_ratio,
11 ),
12 thinking_config=types.ThinkingConfig(
13 include_thoughts=True # 启用思考过程
14 )
15 )
16)
17
18# 显示图像和思考过程
19for part in response.parts:
20 if part.thought:
21 print(f"思考过程: {part.text}")
22 elif image:= part.as_image():
23 image.save("viral.png")

然后,你应该会得到类似下面的内容:

text
1## 构思羊驼通勤者
2
3我正专注于羊驼身上。目标是捕捉它们作为
4日常通勤者,在拉巴斯(玻利维亚)一辆繁忙的巴士上的情景。我的计划
5涉及一辆挤满了觉得很有趣的乘客的老式巴士。图像
6将突出显示一只羊驼看着窗外的细节,另一只与乘客互动,
7同时人们在拍照。
8
9[IMAGE]
10
11## 可视化概念
12
13现在我完全沉浸在所请求的场景中。我的主要
14重点是"不寻常但逼真"的方面。场景开始成形,
15关键元素已确立。
Google AI Studio - inline image

这种透明性帮助你理解模型如何解读你的请求。这就像与你的艺术家进行对话!

6. 搜索接地(实时魔法)

最具变革性的功能之一是搜索接地。Nano Banana Pro 不受限于过时的信息;它可以访问来自 Google 搜索的实时数据,以生成准确、最新的图像。想要天气信息?没问题。

例如,你可以让它可视化当前的天气预报:

python
1prompt = "将东京未来 5 天的天气预报可视化为一个简洁、现代的天气图表。并添加我应该每天穿什么的视觉提示"
2
3response = client.models.generate_content(
4 model=PRO_MODEL_ID,
5 contents=prompt,
6 config=types.GenerateContentConfig(
7 response_modalities=['Text', 'Image'],
8 image_config=types.ImageConfig(
9 aspect_ratio="16:9",
10 ),
11 tools=[{"google_search": {}}] # 启用 Google 搜索
12 )
13)
14
15# 保存图像
16for part in response.parts:
17 if image:= part.as_image():
18 image.save("weather.png")
19
20# 显示来源(你必须始终这样做)
21print(response.candidates[0].grounding_metadata.search_entry_point.rendered_content)
Google AI Studio - inline image

7. 要大就要最大:4K 生成

需要打印质量的图像?Nano Banana Pro 支持 4K 分辨率。因为有时候,大就是好。

python
1prompt = "一棵经历四季变化的橡树的照片"
2resolution = "4K" # 选项:"1K", "2K", "4K", 注意小写无效。
3
4response = client.models.generate_content(
5 model=PRO_MODEL_ID,
6 contents=prompt,
7 config=types.GenerateContentConfig(
8 response_modalities=['Text', 'Image'],
9 image_config=types.ImageConfig(
10 aspect_ratio="1:1",
11 image_size=resolution
12 )
13 )
14)
Google AI Studio - inline image

注意



:4K 生成成本较高,请明智使用!

8. 多语言香蕉(多语言能力)

该模型可以生成甚至翻译图像内的文本,支持十多种语言。这基本上就是你的视觉版通用翻译器。

python
1# 生成一张西班牙语的信息图
2message = "制作一张用西班牙语解释爱因斯坦广义相对论的信息图,适合六年级学生理解"
3
4response = chat.send_message(message,
5 config=types.GenerateContentConfig(
6 image_config=types.ImageConfig(aspect_ratio="16:9")
7 )
8)
9
10# 保存图像
11for part in response.parts:
12 if image:= part.as_image():
13 image.save("relativity.png")
Google AI Studio - inline image
python
1# 将其翻译成日语
2message = "将这张信息图翻译成日语,保持其他所有内容不变"
3response = chat.send_message(message)
4
5# 保存图像
6for part in response.parts:
7 if image:= part.as_image():
8 image.save("relativity_JP.png")
Google AI Studio - inline image

9. 混合搭配!(高级图像混合)

虽然 Flash 模型可以混合最多 3 张图像,但 Pro 模型可以处理多达 14 张图像!这就像在一个提示里开了一整个派对。非常适合创建复杂的拼贴画或展示你的整个产品线。

python
1# 混合多张图像
2response = client.models.generate_content(
3 model=PRO_MODEL_ID,
4 contents=[
5 "这些人在一起拍的办公室集体照,他们正在做鬼脸。",
6 PIL.Image.open('John.png'),
7 PIL.Image.open('Jane.png'),
8 # ... 最多可以添加 14 张图像
9 ],
10)
11
12# 保存图像
13for part in response.parts:
14 if image:= part.as_image():
15 image.save("group_picture.png")
Google AI Studio - inline image

注意



:如果你希望角色具有非常高的保真度,请将数量限制在 5 张以内,这对于一个派对之夜来说已经绰绰有余了!

10. 炫耀时间!(Pro 专属演示)

以下是一些只有使用 Nano Banana Pro 才能实现的例子。准备好被震撼吧:

个性化像素艺术(搜索接地)

<提示**</p>



: "搜索网络,然后生成一张等轴测视角的、详细的像素艺术图像,展示 Guillaume Vernade 的职业生涯"

这利用了搜索接地来查找关于某个人的具体信息,并以特定风格将其可视化。

Google AI Studio - inline image

复杂文本整合

<提示**</p>



: "给我展示一张关于十四行诗如何运作的信息图,图中使用一首关于香蕉的十四行诗,并对该诗进行详细的文学分析。风格要复古雅致"

该模型能够生成连贯的长篇文本,并将其完美地整合到复杂的布局中。

Google AI Studio - inline image

高保真模型图

<提示**</p>



: "一张放在舒适剧院座位上的、关于 TCG 玩家的百老汇节目的照片。专业且制作精良,采用光泽纸面,我们可以看到封面和一页展示舞台照片的内页。"

创建具有准确光照和纹理的印刷品的照片级逼真模型图。

Google AI Studio - inline image

11. Nano Banana 和 Nano Banana Pro 的最佳实践与提示技巧

为了在使用 Nano Banana 模型时获得最佳效果,请遵循以下提示指南:

要极度具体:你提供的关于主题、颜色、光照和构图的细节越多,你对输出的控制力就越强。

提供背景信息和意图:解释图像的用途或期望的情绪。模型对上下文的理解会影响其创意选择。

迭代与优化:不要指望第一次尝试就能完美。利用模型的对话能力进行增量更改并优化你的图像。

使用逐步说明:对于复杂场景,将你的提示分解为一系列清晰、顺序的指令。

使用正面表述:不要使用像"没有汽车"这样的负面提示,而是正面描述你想要的场景:"一条空旷、荒芜的街道,没有任何交通迹象。"

控制相机:使用摄影和电影术语来指导构图,例如"广角镜头"、"微距镜头"或"低角度视角"。

利用搜索接地为你服务:当你知道希望模型使用实时或现实世界的数据时,要非常精确地说明。"搜索网络关于里昂奥林匹克队上一场比赛的信息并制作一张信息图"会比仅仅"一张关于 OL 最近比赛的信息图"效果更好(后者理论上也应该可行,但不要冒险)。

使用 Batch API 来降低成本并获取更多配额:Batch API 是一种将小型或非常大批量的请求一起发送的方式。它们可能需要最多 24 小时才能处理完成,但作为交换,你可以节省 50% 的生成成本。而且配额也更高!

有关最佳实践的深入探讨,请查看文档中的提示指南以及官方博客上发布的关于 Nano Banana 的提示最佳实践

总结

Nano Banana Pro(Gemini 3 Pro Image)为 AI 图像生成开辟了新领域。凭借其思考、搜索和渲染 4K 图像的能力,它是一个面向严肃创作者(以及严肃娱乐)的工具。

准备好试试了吗?前往 Google AI Studio,尝试或自定义我们的 应用,或查看 cookbook

一键保存

使用 YouMind AI 深度阅读爆款文章

保存原文、追问细节、总结观点,并在一个 AI 工作空间里把爆款文章沉淀成可复用笔记。

了解 YouMind
写给创作者

把你的 Markdown 变成干净的 𝕏 文章

图片上传、表格、代码块,往 𝕏 上手动重排太痛苦。YouMind 把整篇 Markdown 一键转成干净、可直接发布的 𝕏 文章草稿。

试试 Markdown 转 𝕏

更多可拆解样本

近期爆款文章

探索更多爆款文章