Last updated: 2026-09-18

​

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 default public contract remains URL-based image_input; designated gray-release accounts additionally support data URLs, raw Base64, and three-image multipart editing
• data URLs, Base64, and multipart are Crazyrouter compatibility extensions, not a claim that every upstream carrier natively supports them
• 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

• data URLs, raw Base64, and multiple image_input images on /v1/images/generations
• multipart image, image[], and image[n] fields on /v1/images/edits
• three-image ordering for original, annotation, and reference images

• 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
• gray user 11257 with three 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 normally use official Gemini / Vertex carriers; designated gray accounts may use an explicitly verified gray carrier
• that is a server-side routing rule; the customer contract stays the same

​

Gray three-image multipart editing

curl -X POST https://api.crazyrouter.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=nano-banana-pro" \
  -F "prompt=Use image one as the original, image two as the annotation, and image three as the reference. Edit only the annotated area." \
  -F "image[]=@original.png" \
  -F "image[]=@annotation.png" \
  -F "image[]=@reference.png"

​

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

• Non-gray accounts cannot use image, data: / Base64, or multipart image input
• The gray path is verified up to three images; higher limits are not promised 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

​

Related on crazyrouter.com

• Nano Banana Pro model page: live price, real samples, code
• Nano Banana 2 model page: live price, real samples, code
• All Google models with live prices