Documentation Index

Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Nano Banana Pro

POST /v1/images/generations

​

这页覆盖什么

• 本页只覆盖 nano-banana-pro / nano-banana-pro
• 客户请求入口统一是 POST /v1/images/generations
• 输入图片字段统一是 image_input
• 当前公开协议收紧为 image_input 的 URL 引用，不对外暴露 image 或 data: 输入
• 背后承载可以是 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

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

​

请求参数

​

多图当前状态

• 2 张：已验证
• 更高张数：上游 exact max 仍待补测，暂不对外承诺

​

路由说明

• 单图请求可以命中常规可用承载
• 多图请求当前只会路由到官方 Gemini / Vertex carrier
• 这是服务端内部路由策略，客户协议保持不变

​

请求示例

​

单图编辑

curl -X POST https://cn.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"
  }'

​

文生图

curl -X POST https://cn.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 作为公开输入协议
• 当前文档不承诺高于 2 张的多图输入
• 当前文档不承诺精确 30 MiB URL 边界
• 当前文档不承诺所有截图列出的比例和参数都已经完全闭环