Nano Banana Images API 集成指南

本文将介绍如何集成和使用 Nano Banana Images API。这一接口支持两种功能图像生成 (generate)和图像编辑 (edit)。无论是创建独特的艺术作品还是对现有图像进行修改Nano Banana 都能满足您的需求。环境准备在使用该 API 之前请确保您已在 Ace Data Cloud 平台 上申请到 API 的激活权限。首次申请通常会提供免费的配额。激活后您可以从平台获取用于调用 API 的 Bearer Token。接口概述基础 URL:https://api.acedata.cloud端点:POST /nano-banana/images认证方式: 在 HTTP 头部携带authorization: Bearer {token}请求头:accept: application/jsoncontent-type: application/json操作:generate: 根据文本提示生成图像edit: 根据给定的图像进行编辑模型(可选):nano-banana(默认): 基于 Gemini 2.5 Flash Image快速、低成本nano-banana-2: 基于 Gemini 3.1 Flash Image Preview专业级质量 Flash 速度nano-banana-pro: 基于 Gemini 3 Pro Image Preview最高质量异步回调: 可选通过callback_url接收任务完成通知和结果快速开始生成图像 (actiongenerate)最小必需参数:action,prompt要生成图像请将action设置为generate并提供清晰的prompt。请求示例 (cURL)curl -X POST https://api.acedata.cloud/nano-banana/images \ -H authorization: Bearer {token} \ -H accept: application/json \ -H content-type: application/json \ -d { action: generate, prompt: A photorealistic close-up portrait of an elderly Japanese ceramicist..., count: 1 }请求示例 (Python)import requests url https://api.acedata.cloud/nano-banana/images headers { authorization: Bearer {token}, accept: application/json, content-type: application/json, } payload { action: generate, prompt: ( A photorealistic close-up portrait of an elderly Japanese ceramicist... ), count: 1 } resp requests.post(url, jsonpayload, headersheaders) print(resp.json())成功响应示例{ success: true, task_id: 056f0589-a3dd-4ec2-8440-ad61f5038dfa, trace_id: c48de83f-0077-426e-b02b-ff1d58179064, data: [ { prompt: A photorealistic close-up portrait of an elderly Japanese ceramicist..., image_url: https://platform.cdn.acedata.cloud/nanobanana/69790adb-c85d-4362-ad9e-0c9ba4352cf4.png } ] }字段说明success: 请求是否成功。task_id: 任务 ID。trace_id: 追踪 ID用于故障排除。data[]: 结果列表。prompt: 用于生成的提示回显。image_url: 生成图像的直接 URL。注意生成图像时仅需提供action和prompt。编辑图像 (actionedit)如果您想基于现有图像进行编辑请将action设置为edit并通过image_urls传递待编辑的图像 URL至少 1 个同时提供描述编辑目标的prompt。请求示例 (cURL)curl -X POST https://api.acedata.cloud/nano-banana/images \ -H authorization: Bearer {token} \ -H accept: application/json \ -H content-type: application/json \ -d { action: edit, prompt: let this man wear on this T-shirt, image_urls: [ https://cdn.acedata.cloud/v8073y.png, https://cdn.acedata.cloud/44xlah.png ], count: 1 }请求示例 (Python)import requests url https://api.acedata.cloud/nano-banana/images headers { authorization: Bearer {token}, accept: application/json, content-type: application/json, } payload { action: edit, prompt: let this man wear on this T-shirt, image_urls: [ https://cdn.acedata.cloud/v8073y.png, https://cdn.acedata.cloud/44xlah.png ], count: 1 } resp requests.post(url, jsonpayload, headersheaders) print(resp.json())成功响应示例{ success: true, task_id: 93f11baf-347b-4bb4-9520-8653cb46d6a3, trace_id: a9063166-26ed-4451-85b5-54e896817c69, data: [ { prompt: let this man wear on this T-shirt, image_url: https://platform.cdn.acedata.cloud/nanobanana/8e9e0253-26f4-45b9-b3f8-ac1aed1c284b.png } ] }字段说明image_urls[]: 待编辑图像的 URL 列表必须公开可访问。可以传递多个图像服务将结合这些素材与prompt完成编辑。其他字段与“生成图像”响应相同。异步回调可选推荐生成或编辑可能需要一些时间。为避免长时间连接占用资源建议通过callback_url使用Webhook 回调在请求体中添加callback_url例如您服务器的 Webhook 地址必须公开可访问并支持 POST JSON。API 将立即返回包含task_id的响应或基本结果。当任务完成时平台将通过POST将完整的 JSON 发送到callback_url。您可以使用task_id将请求与结果关联起来。回调有效载荷示例{ success: true, task_id: 6a97bf49-df50-4129-9e46-119aa9fca73c, trace_id: 9b4b1ff3-90f2-470f-b082-1061ec2948cc, data: [ { prompt: a white siamese cat, image_url: https://platform.cdn.acedata.cloud/nanobanana/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.png } ] }错误处理当调用失败时将返回标准错误格式和追踪 ID。常见错误如下400token_mismatched: 请求无效或参数不正确。400api_not_implemented: 接口未实现请联系支持。401invalid_token: 身份验证失败或缺少令牌。429too_many_requests: 请求频率限制超出。500api_error: 服务器异常。错误响应示例{ success: false, error: { code: api_error, message: Internal server error. }, trace_id: 2cf86e86-22a4-46e1-ac2f-032c0f2a4e89 }总结通过 Nano Banana Images API您可以轻松生成和编辑图像提升您的应用程序或项目的视觉表现。无论您是艺术创作者还是应用开发者这一工具都能为您提供强大的支持。希望本文能帮助您顺利集成和使用该 API。技术标签API集成图像处理