Nano Banana 2 API

通过 GoEnhance 的独立 API,用 Nano Banana 2 从文本生成图像。选择支持的比例和 0.5K–4K 输出尺寸,然后通过轮询或回调获取结果。GoEnhance 不是 Google,本端点也不是 Google 官方的 Gemini API。
创建 API Key
象征 Nano Banana 2 图像生成的金色玻璃香蕉雕塑

灵活的文生图生成

植物温室中的半透明琥珀色水果雕塑
无品牌数据中心走廊中的金色光轨
提交生成任务前,请先核对准确的模型 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

1. 提交生成请求

https://api.goenhance.ai/api/v1/images/generations 发送 JSON POST 请求,携带鉴权信息、modelprompt,以及可选的比例、尺寸、联网检索、推理深度或回调字段。
2. 保存 img_uuid
2

2. 保存 img_uuid

从成功响应中读取 data.img_uuid,并将它与你的应用请求关联起来。
3. 轮询或接收回调
3

3. 轮询或接收回调

轮询 GET /api/v1/jobs/detail 或处理回调事件。当你的端点未返回 HTTP 200 时,GoEnhance 文档说明最多重试三次回调,每次尝试的超时时间为三秒。
构建可控的图像生成工作流,由你的应用负责提示词、审核、存储与分发。

Nano Banana 2 API 应用场景

编辑配图

把结构化的选题要点转换成候选视觉素材,交给人工审核队列。

产品叙事

根据产品描述生成场景概念,供后续品牌与合规审核。

营销素材变体

生成提示词与宽高比的多种变体,同时独立跟踪每个异步任务。

本地化工作流

用本地化的提示词生成面向特定地区的视觉概念,无需改动你的任务处理架构。

概念开发

在确定正式生产素材之前,先探索角色、道具、场景和美术方向。

自动化创意流水线

把回调接入内容审核、审批、存储或下游素材处理服务。
关于价格、参数、异步交付以及 Google API 意图的实用解答。

Nano Banana 2 API 常见问题

开始用 Nano Banana 2 API 构建