Contenido actualizado: 2026-09-28

​

Nano Banana Pro

POST /v1/images/generations

​

¿Qué cubre esta página?

• Esta página cubre únicamente nano-banana-pro / nano-banana-pro
• El punto de entrada para las solicitudes de clientes es siempre POST /v1/images/generations
• El campo para imágenes de entrada es siempre image_input
• Se recomienda seguir usando la URL del protocolo público predeterminado image_input; las cuentas grises también soportan dataURL, Base64 bruto y edición de imágenes con multipart de tres imágenes
• data: / Base64 / multipart es una extensión compatible de Crazyrouter, no implica que todos los carriers nativos lo soportan
• El backend puede soportar Gemini / Vertex u otros proveedores, pero los detalles de estos proveedores no forman parte del protocolo para el cliente
• No envíes desde el lado del usuario generationConfig, imageConfig, imageOutputOptions, image_output_options; estos campos son convertidos automáticamente por Crazyrouter desde parámetros unificados

​

Nombre del modelo

​

Estado de las capacidades

​

Capacidades actualmente validadas

• Vertex oficial, conexión directa channel 318 (vertexsophie) validada:
  • 2 imágenes de referencia disponibles
• Puerto local 4000, channel 318 fijo validado:
  • Una referencia de imagen única por URL WEBP disponible
  • Una referencia de imagen única por URL JPEG disponible
  • 2 imágenes de referencia por URL PNG disponibles
  • resolution: "1K" disponible
  • resolution: "4K" disponible
  • aspect_ratio: "1:1" disponible
  • aspect_ratio: "21:9" disponible
  • output_format: "png" disponible
  • output_format: "jpg" disponible
• Se puede devolver directamente data[].url en la respuesta

• /v1/images/generations de image_input soporta dataURL, Base64 bruto y entradas con múltiples imágenes
• /v1/images/edits soporta multipart en image, image[], image[n]
• Imagen original, imagen anotada, imagen de referencia pueden componerse en una solicitud de edición de tres imágenes según orden de subida

• Límite máximo de imágenes precisas sea 8 o superior
• 2K
• Límite máximo de URL de archivo grande precisas
• Precisión de borde de 30 MiB
• Otras combinaciones de aspect_ratio
• Precisión semántica de los bordes en output_compression

​

Parámetros de solicitud

​

Estado actual de múltiples imágenes

• 2 imágenes: validado
• 11257 gris de tres imágenes: validado
• Mayor cantidad: el máximo exacto aún no ha sido probado, no comprometido por ahora

​

Descripción de enrutamiento

• Solicitud de imagen individual puede ir por canal regular
• Solicitud de varias imágenes solo será enrutada al carrier oficial Gemini / Vertex; la cuenta gris puede usar carriers grises validados
• Esto es una estrategia interna de enrutamiento, el protocolo del cliente no se modifica

​

Multipart gris de tres imágenes

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"

​

Ejemplos de solicitud

​

Edición de una imagen

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"])

​

Generación de imagen por texto

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
  }'

​

Referencia doble de imagen

{
  "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"
}

​

Ejemplos de respuesta

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

​

Resumen de resultados validados

​

Limitaciones actualmente conocidas

• Las cuentas que no sean gris no aceptan image, data: / Base64 ni entrada de imagen multipart
• La cuenta gris ha validado hasta tres imágenes, no se garantiza un límite superior
• Este documento no promete el límite preciso para 30 MiB URL
• Este documento no asegura que todas las proporciones y parámetros mostrados en las capturas estén completamente cerrados

​

Páginas relacionadas

• Página del modelo Nano Banana Pro: precios en tiempo real, ejemplos reales, código de invocación
• Página del modelo Nano Banana 2: precios en tiempo real, ejemplos reales, código de invocación
• Todos los modelos y precios de Google