更新日期：2026-09-18

​

Nano Banana Pro

POST /v1/images/generations

​

这页覆盖什么

• 本页只覆盖 nano-banana-pro / nano-banana-pro
• 客户请求入口统一是 POST /v1/images/generations
• 输入图片字段统一是 image_input
• 默认公开协议仍建议使用 image_input URL；指定灰度账号已额外支持 dataURL、raw Base64 和三图 multipart 图片编辑
• data: / Base64 / multipart 是 Crazyrouter 的兼容扩展，不代表所有上游 carrier 原生支持
• 背后承载可以是 Gemini / Vertex 等 provider，但这些 provider 细节不属于客户协议的一部分
• 用户侧不要传 generationConfig、imageConfig、imageOutputOptions、image_output_options；这些字段由 Crazyrouter 从统一参数自动转换

​

模型名

​

能力状态

​

当前已验证能力

• 官方 Vertex channel 318 (vertexsophie) 直连已验证：
  • 2 张参考图可用
• 本地 4000 端口、固定 channel 318 已验证：
  • 单张 WEBP URL 参考图可用
  • 单张 JPEG URL 参考图可用
  • 2 张 PNG URL 参考图可用
  • resolution: "1K" 可用
  • resolution: "4K" 可用
  • aspect_ratio: "1:1" 可用
  • aspect_ratio: "21:9" 可用
  • output_format: "png" 可用
  • output_format: "jpg" 可用
• 响应可直接返回 data[].url

• /v1/images/generations 的 image_input 支持 dataURL、raw Base64 和多图输入
• /v1/images/edits 支持 multipart 的 image、image[]、image[n]
• 原图、批注图、参考图可按上传顺序组成三图编辑请求

• 精确多图上限是否为 8 或更高
• 2K
• 精确大文件 URL 上限
• 精确 30 MiB 边界
• 其他 aspect_ratio 组合
• output_compression 的精确语义边界

​

请求参数

​

多图当前状态

• 2 张：已验证
• 11257 灰度三图：已验证
• 更高张数：上游 exact max 仍待补测，暂不承诺

​

路由说明

• 单图请求可以命中常规可用承载
• 默认多图请求只会路由到官方 Gemini / Vertex carrier；指定灰度账号可使用已验证的灰度 carrier
• 这是服务端内部路由策略，客户协议保持不变

​

灰度三图 multipart

curl -X POST https://api.crazyrouter.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=nano-banana-pro" \
  -F "prompt=以第一张为原图，第二张为批注图，第三张为参考图，仅修改批注区域" \
  -F "image[]=@original.png" \
  -F "image[]=@annotation.png" \
  -F "image[]=@reference.png"

​

请求示例

​

单图编辑

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "把这张商品图改成超宽横幅 KV，背景更简洁，保留主体结构",
    "image_input": [
      "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp"
    ],
    "resolution": "4K",
    "aspect_ratio": "21:9",
    "output_format": "png"
  }'

import requests

response = requests.post(
    "https://api.crazyrouter.com/v1/images/generations",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY"
    },
    json={
        "model": "nano-banana-pro",
        "prompt": "把这张商品图改成超宽横幅 KV，背景更简洁，保留主体结构",
        "image_input": [
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp"
        ],
        "resolution": "4K",
        "aspect_ratio": "21:9",
        "output_format": "png"
    }
)

data = response.json()
print(data["data"][0]["url"])

​

文生图

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A premium product poster for a red apple, studio lighting, clean background",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "output_compression": 85
  }'

​

双图参考

{
  "model": "nano-banana-pro",
  "prompt": "融合两张参考图的主体与构图，生成一张高质量主视觉图",
  "image_input": [
    "https://example.com/ref-1.png",
    "https://example.com/ref-2.png"
  ],
  "resolution": "1K",
  "aspect_ratio": "1:1"
}

​

响应示例

{
  "created": 1774846705,
  "data": [
    {
      "url": "https://media.crazyrouter.com/task-artifacts/2026/03/30/sync-image/20260331073825672515332JyP6hAcs-1.png"
    }
  ]
}

​

已验证结果摘要

​

当前已知限制

• 非灰度账号不接受 image、data: / Base64 或 multipart 图片输入
• 灰度账号当前验证到三图，不承诺更高张数上限
• 当前文档不承诺精确 30 MiB URL 边界
• 当前文档不承诺所有截图列出的比例和参数都已经完全闭环

​

相关页面

• Nano Banana Pro 模型页：实时价格、真实样例、调用代码
• Nano Banana 2 模型页：实时价格、真实样例、调用代码
• Google 全部模型与价格