​

Nano Banana 2

POST /v1/images/generations

​

这页覆盖什么

• 本页只覆盖 nano-banana-2
• 客户请求入口统一是 POST /v1/images/generations
• 输入图片字段统一是 image_input
• 当前公开协议收紧为 image_input 的 URL 引用，不对外暴露 image 或 data: 输入
• 背后承载可以是 Gemini / Vertex 等 provider，但这些 provider 细节不属于客户协议的一部分

​

能力状态

​

当前已验证能力

• 单张参考图编辑可用
• 2 张参考图可用
• 14 张参考图可用
• 15 张参考图会被拒绝
• resolution: "1K" 可用
• resolution: "2K" + aspect_ratio: "16:9" 可用
• WEBP URL 引用已验证通过
• PNG 已有成功样本，但不同来源稳定性还未完全收敛

• URL 输入的精确大文件上限
• 精确 30 MiB 边界
• JPEG URL 输入稳定性
• 官方 Gemini 直连真值

​

请求参数

​

aspect_ratio 当前可接受值

​

多图上限

• 1 到 14 张：当前公开范围
• 15+：服务端直接拒绝，错误信息为 at most 14 reference images are currently supported for nano-banana-2

​

请求示例

​

单图编辑

curl -X POST https://crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "把这张商品图改成电商白底主图，保留主体结构",
    "image_input": [
      "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp"
    ],
    "resolution": "1K",
    "aspect_ratio": "1:1"
  }'

​

多图参考

{
  "model": "nano-banana-2",
  "prompt": "融合这些参考图的主体和构图，生成一张新的海报图",
  "image_input": [
    "https://example.com/ref-1.webp",
    "https://example.com/ref-2.webp",
    "https://example.com/ref-3.webp"
  ],
  "resolution": "2K",
  "aspect_ratio": "16:9"
}

​

响应示例

{
  "created": 1774885716,
  "data": [
    {
      "url": "https://media.crazyrouter.com/task-artifacts/2026/03/30/sync-image/20260330234836357407163eDKH9nsz-1.jpeg"
    }
  ]
}

​

已验证结果摘要

​

当前已知限制

• 不接受 image
• 不接受 data: / Base64 作为公开输入协议
• 当前文档不承诺 JPEG URL 的稳定性
• 当前文档不承诺精确 30 MiB URL 边界