欢迎各位黑客！本仓库是 Google DeepMind 主办的 纳米香蕉48小时挑战赛 的官方入门工具包与资源中心。你开始、打造精彩项目并提交所需的一切，都在这里。

一起玩转香蕉吧！ 从2025年9月6日起的48小时内，我们将开放 Gemini API 的特别48小时免费层级，把我们最先进的图像模型——Gemini 2.5 Flash Image Preview（又名“纳米香蕉”）——交到你手中。同时，我们还联合 Fal 和 ElevenLabs 提供超过40万美元的奖金！我们非常期待在接下来的两天里看到你的作品！

“纳米香蕉”的核心在于动态创作：用文字编辑、融合现实，并利用 Gemini 独特的世界知识。我们诚邀你释放这一强大能力，向我们展示一款能够改变我们与视觉内容交互方式、实现前所未有效果的应用。

快速导航

• 🚀 三步快速入门
• 🎯 挑战赛简介
• 🛠️ 技术资源
• 🏆 提交与评审
• 🗓️ 时间线与奖项
• 💬 帮助与讨论

🚀 三步快速入门

1. 获取免费 API 密钥

   • 按照 API 密钥指南 创建你的 API 密钥，以访问 Gemini API 上的“纳米香蕉”。

2. 探索资源

   • 克隆此仓库以获取代码示例，并查看外部链接以获得灵感和文档支持。

3. 在 Kaggle 上提交项目

   • 准备就绪后，请前往 官方 Kaggle 比赛页面 在截止日期前提交你的项目。

🎯 挑战赛简介

你的任务是构建一个产品、应用或演示，充分展现以下一项或多项核心优势。请跳出简单的文本生成图像的思维模式，思考这些高级功能如何创造出令人惊叹的用户体验？

可以考虑以下应用场景：

• 增强动态叙事（例如连贯角色的漫画创作）。
• 革新电子商务（例如虚拟房间摆放或产品可视化）。
• 自动化创意工作流（例如大规模个性化营销素材）。
• 打造下一代自然语言照片编辑器。

🛠️ 技术资源

• 从这里开始：获取 API 密钥：分步指导你获取免费的 Gemini API 密钥，并使用 Python 生成第一张“纳米香蕉”图像。
  • 使用纳米香蕉：学习如何运用“纳米香蕉”生成和编辑图像的不同方法。
• examples/：包含独立的代码片段，演示 Gemini API 的特定功能。
  • JavaScript 入门
• 🌐 官方“纳米香蕉”Gemini API 文档：https://ai.google.dev/gemini-api/docs/image-generation
• ✍️ 提示指南与策略：https://ai.google.dev/gemini-api/docs/image-generation#prompt-guide
• 🍳 进阶教程（高级用法）：
  • Python：图像理解快速入门（Colab）
  • JavaScript：图像理解入门（AI Studio）
• ✨ 灵感应用小工具：通过这些互动式演示，了解“纳米香蕉”的无限可能。
  • GemBooth
  • Home Canvas
  • Past Forward
  • PixShop

合作伙伴资源 🤝

探索我们的合作伙伴提供的工具和平台，以进一步提升你的项目。

ElevenLabs

• 开始使用 ElevenLabs API
• 开始使用 ElevenLabs Agents
• 展示你的作品
• 在 X 上关注最新动态
• 观看 YouTube 视频

fal.ai

• 在 fal.ai 创建账户
• 登录后生成你的 API 密钥
• 开始构建：可在 此处 找到 JavaScript 和 Python 示例代码

🏆 提交与评审

你的项目将主要根据视频演示进行评判。用行动证明一切！我们希望看到你的作品带来的震撼效果、实际用途以及背后的技术实力。

提交方式

所有提交必须通过官方比赛页面完成：

https://www.kaggle.com/competitions/banana

提交要求

完整的 Kaggle 提交需包括以下内容：

1. 🎥 视频演示（不超过2分钟）

   • 一段生动有趣的视频，展示你的项目成果。视频必须公开发布（如 YouTube 或 X/Twitter），且无需登录即可观看。

2. 🔗 公开项目链接

   • 一个指向你正在运行的产品或交互式演示的 URL。如果无法提供实时演示，则需要提供一个带有清晰部署说明的公共代码仓库链接（如 GitHub）。

3. ✍️ Gemini 集成说明（最多200字）

   • 简要描述你使用了 Gemini 2.5 Flash Image 的哪些功能，以及这些功能如何成为你应用的核心。

评审标准

• 💡 创新性与震撼力（40%）：应用是否具有创造性和新颖性？它是否以一种前所未有的方式利用了 Gemini 2.5 Flash Image？
• ⚙️ 技术实现与功能性（30%）：应用是否正常运行？它是否有效地利用了 API 的高级特性（一致性、融合、编辑等）？
• 📈 潜在影响与实用性（20%）：应用是否解决了现实世界中的问题（创意、商业或教育方面）？
• 🎬 呈现质量（10%）：视频演示的清晰度、叙事能力和吸引力。

对于特别技术奖，将采用相同的评审标准，但会重点关注特定技术（ElevenLabs）如何在实现项目影响力和技术卓越性方面起到关键作用。

🗓️ 时间线与奖项

💰 奖项

争夺总额超过 40万美元的奖金！

综合赛道

• 前50名参赛作品：每份可获得5,000美元的Gemini API积分及1,000美元的Fal积分，此外还有1,100万（约合2,000美元）的ElevenLabs积分。

特别技术奖——ElevenLabs

• 冠军：2,200万ElevenLabs积分（6个月Scale套餐，估值约4,000美元）

⏳ 重要日期

• 比赛开始：2025年9月6日（UTC时间9月5日午夜00:01，太平洋时间下午5:00）
• 最终提交截止：2025年9月7日（UTC时间下午4:59，太平洋时间晚上11:59）
• 评审阶段：2025年9月8日至17日
• 公布获奖名单：2025年9月19日（预计）

评审所需时间取决于参赛作品的数量。除非另有说明，所有截止时间均为对应日期的UTC晚上11:59。主办方保留调整时间安排的权利。

关于API使用须知

请注意，Gemini API设有特别层级（适用于所有API用户），每日每个项目允许 500次请求。

使用付费API密钥的开发者需自行支付全部使用费用。如需享受免费的500次生成额度，请使用免费层级的API密钥。

💬 寻求帮助与讨论

所有问题、组队及讨论均将在Kaggle平台上进行。这里是向主办方、导师及社区寻求帮助的最佳场所。

• 提问：发布您的技术或一般性问题，供社区和主办方解答。
• 寻找队友：发布帖子寻找合作伙伴。
• 分享创意：讨论您的项目构想并获取反馈。

前往官方Kaggle讨论区

祝您编码愉快！

Nano Banana Hackathon Kit 快速上手指南

本指南旨在帮助开发者快速接入 Google DeepMind 推出的 Nano Banana (Gemini 2.5 Flash Image Preview) 模型，参与 48 小时挑战赛。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS 或 Linux。
• Python 版本：推荐 Python 3.10 或更高版本。
• 前置依赖：
  • pip (Python 包管理工具)
  • Git (用于克隆代码库)
  • Google Cloud 账号 (用于获取 API Key)
• 网络环境：由于涉及 Google API 调用，请确保您的网络环境可以正常访问 ai.google.dev 及相关服务。

安装步骤

1. 克隆项目仓库

首先，将官方提供的 starter kit 克隆到本地，以获取示例代码和详细文档。

git clone https://github.com/google-gemini/nano-banana-hackathon-kit.git
cd nano-banana-hackathon-kit

2. 创建虚拟环境并安装依赖

建议创建独立的虚拟环境以避免依赖冲突。

python -m venv venv
source venv/bin/activate  # Windows 用户请使用: venv\Scripts\activate
pip install -r requirements.txt

(注：如果根目录没有 requirements.txt，请至少安装核心库)

pip install google-generativeai

3. 获取 API Key

本项目核心依赖于 Gemini API。请按照仓库内提供的指南获取免费的 API Key：

1. 运行或查看指南笔记：./guides/01-getting-your-api-key.ipynb
2. 访问 Google AI Studio 或 Kaggle 竞赛页面申请 Nano Banana 专用免费额度。
3. 将获取的 Key 设置为环境变量：

export GEMINI_API_KEY="你的_API_KEY"
# Windows PowerShell: $env:GEMINI_API_KEY="你的_API_KEY"

基本使用

获取 API Key 后，您可以使用 Python 快速调用 Nano Banana 进行图像生成或编辑。以下是最简单的调用示例：

图像生成示例 (Python)

创建一个名为 quick_start.py 的文件，输入以下代码：

import google.generativeai as genai
from google.generativeai.types import HarmCategory, HarmBlockThreshold

# 配置 API Key
genai.configure(api_key="你的_API_KEY")

# 选择 Nano Banana 模型 (Gemini 2.5 Flash Image Preview)
# 注意：具体模型名称请以官方最新文档为准，此处为示例占位符
model = genai.GenerativeModel('gemini-2.5-flash-image-preview')

# 定义提示词
prompt = "A futuristic city made of bananas, cyberpunk style, highly detailed."

# 生成图像
response = model.generate_content(
    prompt,
    generation_config={"response_mime_type": "image/png"}
)

# 保存图像
if response.candidates[0].content.parts[0].inline_data:
    image_data = response.candidates[0].content.parts[0].inline_data.data
    with open("output_banana_city.png", "wb") as f:
        f.write(image_data)
    print("图像生成成功！已保存为 output_banana_city.png")
else:
    print("未返回图像数据，请检查模型响应。")

运行测试

在终端执行脚本：

python quick_start.py

如果配置正确，您将看到生成的图像文件。更多高级功能（如图像编辑、角色一致性控制）请参考 ./guides/02-use-nano-banana.ipynb 和 ./examples/ 目录下的完整案例。

---

提示：免费层级每个项目每天限制 500 次请求。请在开发过程中合理分配配额，并在截止日期前通过 Kaggle 竞赛页面 提交您的作品。