Nano Banana 2 API
通过 GoEnhance 的独立 API,用 Nano Banana 2 从文本生成图像。选择支持的比例和 0.5K–4K 输出尺寸,然后通过轮询或回调获取结果。GoEnhance 不是 Google,本端点也不是 Google 官方的 Gemini API。
创建 API Key
灵活的文生图生成
提示词与输出控制
将 model 设为 nano-banana-2,并传入 1–2000 个字符的提示词。可选择文档中列出的宽高比、输出尺寸和可选的推理深度。

异步任务交付
提交成功后返回 img_uuid。轮询 GET /api/v1/jobs/detail,或提供公网可访问的 HTTPS 回调 URL 以接收状态更新。

提交生成任务前,请先核对准确的模型 ID 和文档中列出的字段。
Nano Banana 2 API 参数
模型
必填。<code>model</code> 必须精确设为 <code>nano-banana-2</code>。
提示词
必填的文本描述,长度为 1 到 2000 个字符。
宽高比
可选参数 <code>ratio</code>。支持的取值为 auto、1:1、16:9、9:16、4:3、3:4、2:3、3:2、4:5、5:4、21:9、1:4、4:1、1:8 和 8:1。
图片尺寸
可选参数 <code>image_size</code> 默认为 <code>1k</code>;可用取值为 <code>0.5k</code>、<code>1k</code>、<code>2k</code> 和 <code>4k</code>。
生成控制项
可选控制项包括 <code>web_search</code>,以及区分大小写的 <code>thinking_level</code> 取值 <code>High</code> 或 <code>Minimal</code>。
鉴权与回调
请发送 <code>Authorization</code> 请求头。可选的 <code>custom_callback_url</code> 必须是公网可访问的 HTTPS URL。
价格按生成的每张图片计算,并随请求的输出尺寸变化。
Nano Banana 2 API 价格与任务行为
0.5K 与 1K 价格
0.5K 每张图片消耗 3 个 token($0.060)。1K 每张图片消耗 3.3 个 token($0.066)。
2K 与 4K 价格
2K 每张图片消耗 5 个 token($0.100)。4K 每张图片消耗 7.5 个 token($0.150)。
异步结果
提交返回的是 <code>img_uuid</code>,而不是最终图片。请轮询任务详情端点或处理回调事件,以获取最终结果。
三步接入 Nano Banana 2
1
1. 提交生成请求
向
https://api.goenhance.ai/api/v1/images/generations 发送 JSON POST 请求,携带鉴权信息、model、prompt,以及可选的比例、尺寸、联网检索、推理深度或回调字段。 2
2. 保存 img_uuid
从成功响应中读取
data.img_uuid,并将它与你的应用请求关联起来。 3
3. 轮询或接收回调
轮询
GET /api/v1/jobs/detail 或处理回调事件。当你的端点未返回 HTTP 200 时,GoEnhance 文档说明最多重试三次回调,每次尝试的超时时间为三秒。构建可控的图像生成工作流,由你的应用负责提示词、审核、存储与分发。
Nano Banana 2 API 应用场景
编辑配图
把结构化的选题要点转换成候选视觉素材,交给人工审核队列。
产品叙事
根据产品描述生成场景概念,供后续品牌与合规审核。
营销素材变体
生成提示词与宽高比的多种变体,同时独立跟踪每个异步任务。
本地化工作流
用本地化的提示词生成面向特定地区的视觉概念,无需改动你的任务处理架构。
概念开发
在确定正式生产素材之前,先探索角色、道具、场景和美术方向。
自动化创意流水线
把回调接入内容审核、审批、存储或下游素材处理服务。
关于价格、参数、异步交付以及 Google API 意图的实用解答。
