Introducción
Nano Banana Pro Texto a imagen es el Gemini 3 Pro Image de Google, lanzado el 20 de noviembre de 2025, que genera imágenes a partir de un prompt escrito. Razona sobre la solicitud antes de dibujar, lo que ayuda con el texto denso, los diagramas y los diseños de varias partes, y genera en 1k, 2k o 4k en diez formatos, desde muy por debajo de las tarifas de Google.
Elige el modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | Nano Banana Pro Texto a imagen |
| una imagen que quieres cambiar | Nano Banana Pro Edición de imagen |
Funciones y aspectos destacados
Ruta económica y Official fallback
Las solicitudes empiezan en una ruta económica, a un precio muy por debajo del precio de lista de Google. Con Official fallback (activado de forma predeterminada), una solicitud que esa ruta no puede completar vuelve a ejecutarse en la ruta oficial al precio oficial. En ambos casos el modelo es Gemini 3 Pro Image de Google con su paso de razonamiento.
Planea antes de dibujar
El modelo resuelve primero el diseño, así que los prompts que describen dónde va cada elemento o citan varias líneas de texto vuelven ordenados como se escribieron. En nuestra prueba de portada cada línea citada quedó donde el prompt la puso.
El mismo precio para 1k y 2k
Google cobra lo mismo por 1K y 2K, así que 2k es resolución prácticamente gratis; 4k cuesta más. La mayoría de nuestros renders en 2k volvieron en 20 a 45 segundos.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5.000 caracteres. Describe el sujeto, el escenario, la luz y el lente con frases completas; las palabras entre comillas se escriben como texto en la imagen. mínimo 1 caracteres · máximo 5000 caracteres |
aspect_ratio | No | Uno de diez formatos de 21:9 a 9:16; 16:9 de forma predeterminada. El formato no cambia el precio. |
resolution | No | 1k (predeterminado), 2k o 4k. 1k y 2k cuestan lo mismo; 4k cuesta más y genera 4096 píxeles en el lado largo. |
official_fallback | No | Activado por defecto. Cada solicitud se ejecuta primero por la ruta económica. Valor predeterminado: |
Precios
Se cobra por imagen según el nivel de tamaño; la relación de aspecto no cambia el precio. Cada solicitud empieza en la ruta económica, al precio económico. Con Official fallback (activado de forma predeterminada), una solicitud que la ruta económica rechaza o no puede completar vuelve a ejecutarse en la ruta oficial al precio oficial, así que la cotización muestra el precio inicial y el monto máximo; desactívalo para pagar solo el precio económico. Las solicitudes rechazadas no se cobran.
| Especificación | Precio |
|---|---|
| $0.0668 / imagen (Con Official fallback: hasta $0.1072) |
| $0.0668 / imagen (Con Official fallback: hasta $0.1072) |
| $0.118 / imagen (Con Official fallback: hasta $0.192) |
Casos de uso
Retratos editoriales y de marca
Retratos que siguen un lente, una apertura y una luz nombrados, para presentaciones, moodboards y borradores de campaña.
Diseños con texto
Pósteres, portadas, menús y señalización donde varios textos comparten el cuadro con una imagen y cada uno debe estar bien escrito.
Diagramas e infografías
Diagramas con etiquetas, gráficos sencillos y visuales paso a paso, donde el razonamiento ayuda a mantener cada etiqueta en la parte correcta.
Guía de prompts y consejos prácticos
Escríbelo como una lista de tomas
Sujeto, vestuario, escenario, lente, apertura, dirección de la luz y tratamiento de color, en ese orden y con frases completas.
Cita y ubica todo el texto
Cada palabra que deba aparecer va entre comillas con una posición; las palabras sin comillas se leen como descripción.
Empieza en 2k
Con este modelo cuesta lo mismo que 1k, así que genera en 2k de forma predeterminada y deja 4k para imprenta.
Sé literal con la cámara
Un lente de 85 mm a f/1.4 con luz de ventana desde la derecha se sigue al pie de la letra; palabras vagas como cinematográfico dejan la elección al modelo.
Describe a las personas por lo que visten y hacen
Pose, ropa, expresión y dónde está cada persona le dan al paso de planificación lo necesario para ubicar a todos correctamente.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
