Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe the image you want. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 1k · 2k · 4k · Por defecto: 1k |
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 · Por defecto: 16:9 |
output_format | No | Tipo de archivo del resultado. png · jpeg · Por defecto: png |
enable_web_search | No | Consulta primero la web para fechas, lugares y datos actuales. Por defecto: false |
enable_image_search | No | Busca primero fotos reales de un lugar o producto. Por defecto: false |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por imagen | ≈ USD |
|---|---|---|
| resolution 1K | 7,2 | 0,072 US$ |
| resolution 2K | 10,8 | 0,11 US$ |
| resolution 4K | 24,3 | 0,24 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 8 créditos por imagen (0,08 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Nano Banana 2.1 en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model google/nano-banana-2.1/text-to-image y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2.1/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "16:9",
"resolution": "1k",
"output_format": "png"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Nano Banana 2.1
¿Cuánto cuesta la API de Nano Banana 2.1?
Nano Banana 2.1 cuesta desde 8 créditos (0,08 US$) por imagen con Crear imagen, su tarea más barata. Precios por opción: 1K 7,2 créditos por imagen, 2K 10,8 créditos por imagen, 4K 24,3 créditos por imagen. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Nano Banana 2.1 en la API?
Pon google/nano-banana-2.1/text-to-image para Crear imagen; google/nano-banana-2.1/edit para Editar imagen en el campo model de POST /jobs/createTask.
¿Es el Nano Banana 2.1 de Google?
Sí. Las solicitudes se ejecutan en el modelo que Google lanzó el 6 de octubre de 2026 como Nano Banana 2.1, una actualización de Nano Banana 2 (Gemini 3.1 Flash Image). Las salidas de 1K, 2K y 4K coinciden con los tamaños que Google publica para él.
¿Nano Banana 2.1 o Nano Banana 2?
El 2.1 es el modelo más nuevo: Google mejoró la calidad de imagen, el seguimiento del prompt, la consistencia de los personajes y el texto, y dice haber corregido las costuras en banners anchos en 2K y 4K. Nano Banana 2 conserva un nivel de borrador de 0.5K que el 2.1 no tiene. Ambos ofrecen búsqueda web y de imágenes y hasta catorce referencias. Google ha declarado obsoleto Nano Banana 2 (sin fecha de cierre anunciada) y recomienda pasar al 2.1.
¿Qué tan bien escribe texto?
Cada línea que pusimos entre comillas salió escrita tal cual: la cabecera de una revista con dos titulares de portada, el título de una película con su línea de estreno, un letrero de neón de motel y el título de un álbum diseñado sobre una funda en blanco en una edición. La letra pequeña que no escribimos, como la que va bajo el título de un cartel o un código de barras, salió como relleno.
¿De qué tamaño son las imágenes?
En 1:1 los niveles miden 1024, 2048 y 4096 píxeles de lado. Los demás formatos mantienen más o menos la misma cantidad de píxeles: en nuestras pruebas 3:4 en 1k salió de 896 × 1200, 16:9 en 2k de 2752 × 1536 y un banner 8:1 en 2k de 5856 × 704.
¿Qué límites tiene la API de Nano Banana 2.1?
Resoluciones: 1K · 2K · 4K; Relaciones de aspecto: 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 +8; Longitud del prompt (caracteres): 5,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Nano Banana 2.1 sin escribir código?
Sí. El Playground ejecuta Nano Banana 2.1 con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de Nano Banana
Nano Banana Pro planifica la composición antes de dibujar, así que maneja con más cuidado el texto denso, los diagramas y los diseños de varias partes. Nano Banana 2.1 es más nuevo, más rápido y cuesta menos de la mitad por imagen, y añade los banners 8:1 y la búsqueda web y de imágenes.
- API de Nano Banana 2.1La Nano Banana más nueva de Google, texto nítido y salida en 4KDesde 8 créditos por imagen
- API de Nano Banana ProPrimero planea el diseño: mucho texto, diagramas y ediciones en 4KDesde 17 créditos por imagen
- API de Nano Banana 2Imágenes rápidas con Gemini hasta 4K, con hasta 14 referenciasDesde 6 créditos por imagen

