许多图像功能起步都很简单：根据提示词生成一张图片，或者根据产品页面编辑现有图像。难点在于将其转化为一个足够稳定、可供应用程序使用的后端工作流。
本指南展示了如何使用艾斯数据云（Ace Data Cloud）的 Nano Banana 图像 API 构建一个小型的生成与编辑流水线。我们将保持实用性：涵盖一个端点、真实的请求字段、一个 curl 示例、一个 Python 封装器，以及从实验场过渡到应用代码时需要注意的几个要点。
您可以实现的功能
Nano Banana 图像 API 通过同一个端点支持两种操作：
-
generate（生成）：根据文本提示词创建图像 -
edit（编辑）：根据提示词编辑一张或多张输入图像
文档化的接口如下：
- 基础 URL：
https://api.acedata.cloud - 端点：
POST /nano-banana/images - 认证头：
authorization: Bearer {token} - 请求头：
accept: application/json和content-type: application/json - 可选的
callback_url，用于异步完成通知 - 可选的
count，范围为 1 到 4，默认为 1
模型字段是可选的。文档中列出的选项包括 nano-banana、nano-banana-2-lite、nano-banana-2、nano-banana-pro，以及相应的 :official 变体，例如 nano-banana-pro:official。
对于应用程序开发者而言，有用的一点是生成和编辑共享相同的响应结构：成功的调用会返回 success、task_id、trace_id 以及包含图像结果的 data[] 列表。
工作原理
对于生成操作，最低必填字段为 action 和 prompt。如果您需要指定模型，可以添加 model；如果需要多个结果，可以添加 count。
以下是文档化的 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",
"model": "nano-banana-pro",
"prompt": "一位年迈日本陶艺家的照片级写实特写肖像，他有着深深的日晒皱纹和温暖而会心的微笑。他正在仔细检查一只刚上釉的茶碗。场景设定在他那质朴且阳光充足的作坊里。柔和的黄金时刻光线透过窗户洒入，照亮了黏土的细腻纹理。使用 85mm 人像镜头拍摄，背景柔和虚化（散景）。整体氛围宁静而精湛。竖版人像构图。",
"count": 1
}'
成功的响应如下所示：
