Nano Banana 2.1 继续使用 HiAPI 的异步任务接口，所以代码迁移量不大，但有几个输入约束需要重新核对。最明显的变化是 model 值，参考图数量和单张文件大小也发生了变化。价格应以发布前的实时页面和任务记录为准。
本文依据 Nano Banana 2 模型页 和 Nano Banana 2.1 模型页 当前展示的接口契约整理。示例采用当前文档中的请求结构，切换生产流量前应在有余额的测试账户中验证。
最小改动是替换 model
两个版本都通过异步任务创建：
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-nano-banana-2.1",
"input": {
"prompt": "A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "png"
}
}'
如果原来的请求是文生图，迁移重点就是修改 model：
- "model": "nano-banana-2"
+ "model": "gemini-nano-banana-2.1"
文档中的接口仍然是 POST /v1/tasks。请求被接受后，创建接口会返回任务 ID，用于轮询或回调处理。原有的轮询或回调流程可以继续使用，但仍需核对当前任务状态和结果字段。
可以保留的字段，以及必须重新检查的限制
2.1 当前契约保留了 2 版本常用的输入字段：prompt、可选的 image_input、aspect_ratio、resolution 和 output_format。下面的有余额冒烟测试已经接受了文生图和参考图两种形式；正式切换时仍要随版本变化检查实时契约。
参考图限制发生了变化。Nano Banana 2 页面写的是最多 14 张、单张 10 MB；2.1 页面写的是最多 10 张、单张 30 MB。只替换模型 ID、继续转发旧的 14 张图，会导致请求超过新版上限。客户端应按新版上限检查数量，并决定是截断还是直接提示用户。
2.1 模型页没有公开 mask 输入。迁移时不要自行加入 mask 字段，除非后续接口文档明确提供。图片编辑使用 image_input 传入原图，再在 prompt 中写清要修改的内容和需要保留的细节。
{
"model": "gemini-nano-banana-2.1",
"input": {
"prompt": "Keep the amber glass serum bottle and black dropper cap from the reference image. Place it on a sunlit wooden bathroom counter beside a folded cream linen towel and eucalyptus, preserving the bottle shape and blank label.",
"image_input": ["https://static.hiapi.ai/blog/gemini-nano-banana-2-1-ecommerce-product-images/studio.jpg"],
"resolution": "1K",
"aspect_ratio": "16:9",
"output_format": "png"
}
}
这条请求已在有余额的冒烟测试中成功完成，结果图可查看这里。2.1 页面当前写明参考图支持 JPEG、PNG、WebP，单张不超过 30 MB。
价格要分两层核对
截至 2026-10-16 核对模型页时，Nano Banana 2.1 的 1K、2K、4K 档位分别显示为 44、72、116 积分。预算规划前请查看实时价格页和模型页；扣费读回仍待独立核对。
不要把促销价或某个账户页面上的数字写成长期固定价格。上线验证时记录分辨率、提交前展示的金额和任务完成后的实际扣费。
同一提示词切换两个 model ID
为了检查迁移路径，我们分别使用两个公开 model ID 提交了同一条 1K、1:1 提示词。两次请求都成功创建任务并达到 success。两张图中的瓶子和台面细节不同，因此这组结果适合核对路由和结果处理，不足以排名画质，也不能证明商品身份一致。
两次请求使用的提示词：
A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering
| 路由 | Model ID | 结果 |
|---|---|---|
| Nano Banana 2 | nano-banana-2 | 1K、1:1、PNG，任务成功完成 |
| Nano Banana 2.1 | gemini-nano-banana-2.1 | 1K、1:1、PNG，任务成功完成 |
这次迁移验证说明，2.1 的 model ID 可以接受当前文档中的文生图任务结构，并通过同一套异步流程返回图片。单组样本中的画面差异只能作为观察，不能当成模型横评结果。
上线前检查清单
- 把
nano-banana-2替换为确切的新版 ID：gemini-nano-banana-2.1。 - 保留异步
POST /v1/tasks流程和现有任务状态处理。 - 校验
image_input是公开图片 URL 数组，数量最多 10 张。 - 把旧版单张 10 MB 的假设改为 2.1 页面当前写明的 30 MB 限制。
- 保留
prompt、aspect_ratio、resolution、output_format，移除没有文档依据的字段，例如mask。 - 在测试账户分别发送一条纯文本任务和一条参考图编辑任务，保存请求、任务 ID、最终状态、结果 URL 和扣费金额。
- 与旧版本的结果和错误处理做一次对照，再把默认模型切换给全部用户。
价格读回与后续维护
上面的冒烟测试已经验证文生图和图生图的请求结构、任务创建、终态成功和结果 URL。扣费没有从完成任务中独立读回，生产成本仍应以实时价格页和任务记录为准。发布前如果模型页的契约或限制发生变化，也要重新核对。
常见问题
迁移到 Nano Banana 2.1 需要换接口吗？
目前两个模型页都使用 POST /v1/tasks。先修改模型 ID，再用真实请求验证输入和返回结构。
还能使用 nano-banana-2 吗？
这个 ID 仍然表示 Nano Banana 2。需要调用 2.1 时，应使用 gemini-nano-banana-2.1。
迁移后还能传 14 张参考图吗？
2.1 模型页当前列出的上限是 10 张。超过数量时应在客户端减少或拒绝请求。
参考图编辑要换另一个接口吗？
当前页面没有单独的编辑接口。继续使用同一个模型 ID，增加 image_input，并在提示词中说明要改什么、哪些细节要保留。
2.1 对所有账户都更便宜吗？
公开页当前显示各分辨率的标准积分数字较低，但价格可能调整，页面也可能受账户或活动状态影响。做成本结论前，请同时核对实时价格和完成任务后的扣费记录。
