更新日: 2026-06-06

​

Nano Banana Pro

POST /v1/images/generations

​

What This Page Covers

• This page only covers nano-banana-pro
• The customer-facing entry point is POST /v1/images/generations
• The input image field is image_input
• The current public contract is limited to URL references in image_input; image and data: inputs are not exposed publicly
• Gemini / Vertex and other providers may sit behind this route, but those provider details are not part of the customer contract

​

Capability Status

​

Currently Validated Capabilities

• official Vertex channel 318 (vertexsophie) direct truth:
  • 2 reference images work
• local relay on localhost:4000, pinned to channel 318, verified:
  • single WEBP URL reference works
  • single JPEG URL reference works
  • 2 PNG URL references work
  • resolution: "1K" works
  • resolution: "4K" works
  • aspect_ratio: "1:1" works
  • aspect_ratio: "21:9" works
  • output_format: "png" works
  • output_format: "jpg" works
  • the response returns data[].url

• whether the exact multi-image limit is 8 or higher
• 2K
• exact large-file URL limit
• exact 30 MiB boundary
• additional aspect_ratio combinations
• exact output_compression semantics

​

Request Parameters

​

Current Multi-Image Status

• 2 references: verified
• higher counts: exact upstream max is still pending, so do not promise it publicly yet

​

Routing Note

• single-image requests can use normal available carriers
• multi-image requests are currently routed only to official Gemini / Vertex carriers
• that is a server-side routing rule; the customer contract stays the same

​

Request Examples

​

Single-Image Edit

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": "Turn this product image into an ultra-wide hero KV with a cleaner background while preserving the subject",
    "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": "Turn this product image into an ultra-wide hero KV with a cleaner background while preserving the subject",
        "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"])

​

Two-Reference Input

{
  "model": "nano-banana-pro",
  "prompt": "Blend the subject and composition from these two references into one high-quality hero visual",
  "image_input": [
    "https://example.com/ref-1.png",
    "https://example.com/ref-2.png"
  ],
  "resolution": "1K",
  "aspect_ratio": "1:1"
}

​

Response Example

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

​

Validation Snapshot

​

Current Known Limits

• image is not accepted
• data: / Base64 is not part of the public input contract
• the docs do not promise more than 2 references yet
• the docs do not promise the exact 30 MiB URL boundary yet
• the docs do not promise full closure on every screenshot-listed ratio or parameter yet