本文介绍 Nano Banana Images API 的对接与使用。该接口支持两种能力：图像生成（generate） 与 图像编辑（edits）。
要使用 API，需要先识别下方的二维码。
然后在 Ace Data Cloud 平台中进入 Nano Banana Images API 并点击 Acquire 申请开通。首次申请通常会有免费额度可用。开通完成后，即可在平台中获取到用于调用 API 的 Bearer Token。
- Base URL：
- Endpoint：
- 认证方式：HTTP Header 中携带
- 请求头：
-
- 动作（action）：
-
- ：基于给定图片进行编辑
：根据文本提示词生成图片
- 异步回调：可选，通过 接收任务完成通知与结果
最小必需参数：、当你只想根据提示词直接出图时，设置 为 ，并提供清晰的 即可。
请求示例（cURL）
请求示例（Python）
成功返回示例
字段说明
- ：本次请求是否成功。
- ：任务 ID。
- ：链路追踪 ID，便于排查问题。
- ：结果列表。
-
- ：生成图片的直链 URL。
：用于生成的提示词（回显）。
“
注： 仅需 与 即可生成图片
当你希望基于已有图片进行编辑时，设置 为 ，并通过 传入待编辑的图片链接列表（1 张或多张），同时提供描述编辑目标的 。
比如这里我们提供一张人物照片，一张衣服照片，让人物穿上这个衣服，就可以同时传入图片链接，并且指定 action 为 ，URL 可以是 HTTP URL，以 或 协议的公开可访问链接，也可以是 Base64 编码的图片，如
请求示例（cURL）
请求示例（Python）
成功返回示例
字段说明
- ：待编辑图片 URL 列表（必须可公网访问）。可传多张，服务会结合这些素材与 完成编辑。
- 其余字段同「生成图片」返回。
生成或编辑可能需要一定时间。为避免长连接占用资源，建议通过 使用 Webhook 回调：
- 在请求体中添加 ，例如你的服务端 Webhook 地址（需可公网访问，支持 POST JSON）。
- API 会 立即返回 包含 的响应（或包含基本结果）。
- 当任务完成后，平台将以 的方式将完整 JSON 发送至 。你可以通过 将请求与结果关联。
回调载荷示例（字段结构与同步成功返回一致）：
调用失败时会返回标准错误格式与追踪 ID。常见错误如下：
- 400 ：请求不合法或参数错误。
- 400 ：接口未实现（请联系支持）。
- 401 ：鉴权失败或缺少 Token。
- 429 ：请求频率超限。
- 500 ：服务端异常。
错误响应示例
- 必填：、
- 编辑专用：（数组，至少 1 项）
- 可选：（用于异步回调）
- Headers：必须提供 ； 建议设为
- 图片可访问性： 必须为可公网访问Nano Banana 教程的直链（HTTP/HTTPS），建议使用 HTTPS
- 幂等与追踪：保留 与 ，便于故障排查与结果关联
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请联系我们举报，一经查实，本站将立刻删除。
发布者：Ai探索者，转载请注明出处：https://javaforall.net/247445.html原文链接：https://javaforall.net
