Nano Banana 编辑 API

使用 GoEnhance 为您的产品添加提示词引导的图像编辑功能。发送一到四张源图像,选择输出比例,获取任务 ID,并通过轮询或 HTTPS 回调跟踪完成情况。GoEnhance 提供独立的 API 访问权限,并非 Google 的官方 API。
创建 API 密钥
展示 Nano Banana 编辑 API 图像编辑功能的创意工作室场景

专为参考引导式图像编辑而构建

代表参考引导式图像编辑的摄影静物
代表异步图像交付的电影感基础设施场景
在提交编辑请求前请验证这些输入。

Nano Banana 编辑 API 参数

端点

向 <code>https://api.goenhance.ai/api/v1/nano-banana/edit</code> 发送 POST 请求。

授权

在 <code>Authorization</code> 请求头中包含您的 GoEnhance API 凭证。

提示词

一个必需的字符串,用于描述您希望模型执行的图像编辑操作。

图像列表

一个必需的数组,包含 1–4 个源图像对象,每个对象都带有可访问的图像 URL。

输出比例

选择 <code>auto</code>、<code>1:1</code>、<code>16:9</code>、<code>9:16</code>、<code>4:3</code>、<code>3:4</code>、<code>2:3</code> 或 <code>3:2</code>。

回调 URL

可选提供一个公共 HTTPS URL,以接收处理中、成功和失败的任务状态更新。
请根据文档中注明的单图费用和异步响应机制来规划每次编辑请求。

清晰的定价与任务处理

每张图像 2 个代币

Nano Banana 编辑 API 的定价为每张生成图像 2 个代币,根据 GoEnhance 文档,相当于每张图像 $0.04。

任务标识符响应

成功提交后将返回一个 <code>img_uuid</code>。请将其与您的应用程序任务一同存储,以便后续检索最终结果。

回调重试行为

如果您的回调未返回 HTTP 200,GoEnhance 将重试通知,最多尝试三次,每次超时时间为三秒。

分三步集成 Nano Banana Pro 编辑功能

1. 准备请求
1

1. 准备请求

在可访问的 HTTPS URL 上托管一到四张输入图像,编写精确的编辑提示词,选择支持的比例,并可选择添加回调 URL。
2. 提交并持久化
2

2. 提交并持久化

将 JSON 有效载荷 POST 到编辑端点并进行授权,然后在响应用户之前存储返回的 img_uuid
3. 获取结果
3

3. 获取结果

轮询任务详情 API 或验证回调事件,直到任务达到成功或失败状态,然后保存返回的输出 URL 或安全地呈现失败信息。
无需构建自己的模型服务堆栈,即可交付受控的图像编辑工作流。

图像编辑 API 使用案例

产品场景变体

将现有的产品图像置于新的视觉设置中,同时保留源图像作为编辑上下文。

广告创意

为广告、横幅和季节性概念生成由提示词引导的视觉变体。

角色风格重塑

通过明确的提示词,对提供的角色或肖像参考图应用艺术指导变更。

电子商务工作流

自动化处理目录图像的背景、构图或呈现方式变更。

内容本地化

在保持源资产一致的前提下,为区域性广告活动调整场景导向和视觉上下文。

创意原型设计

在确定生产概念之前,测试来自一个或多个参考图的艺术方向。
关于实施、定价和 Google API 搜索意图的实用解答。

Nano Banana Edit API 常见问题解答

使用 Nano Banana Edit API 进行构建