API

Nano Banana 2 Lite API

Imagen

Nano Banana 2 Lite API ofrece una generación de imágenes rápida y eficiente, con consistencia fiable de personajes, fusión fluida de varias imágenes y edición mediante lenguaje natural para flujos creativos del día a día. Integra Nano Banana 2 Lite API para una generación visual ligera y de alta calidad.

Autorizaciones

Bearerstringheaderobligatorio

Clave API para autorizar solicitudes

Cuerpo

application/json

modelstringobligatorio

nano-banana-2-lite

input.promptstringobligatorio

Describe la imagen que quieres crear o los cambios que deseas aplicar a tus imágenes de referencia. Los espacios en blanco se recortan.

Longitud máxima: 5.000 caracteres

input.imagesstring[]opcional

URL opcionales de imágenes de referencia. Usa únicamente URL HTTPS de acceso público. Omite este campo para generar imágenes a partir de texto.

Máximo de elementos: 14

input.aspect_ratiostringopcional

Relación entre el ancho y el alto de salida. Auto permite que el modelo elija.

Predeterminado: auto

auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1

Ejemplos de solicitud

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2-lite",
  "input": {
    "prompt": "Una foto de producto cinematográfica de una cámara futurista con forma de plátano"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "nano-banana-2-lite",
    "status": "processing",
    "credits": 18
  }
}

Consulta este endpoint con el ID de tarea devuelto hasta que la tarea se complete o falle. Recomendamos consultar cada 5 segundos para comprobar el estado más reciente.

POST /api/v1/check

{
  "task_id": "task_example"
}

Respuesta

Estado de la tarea devuelto por POST /api/v1/check. Los ID, URLs y marcas de tiempo siguientes son ilustrativos.

idstringobligatorio

Identificador de la tarea en data.id, igual al task_id enviado en la consulta.

statusstringobligatorio

completed indica que la generación tuvo éxito y data.data contiene los resultados. En otros estados, data.data es null.

failed_reasonstringopcional

Solo se devuelve cuando status es failed, para explicar el fallo. Se omite en completed y processing.

Completada · completed

Las URLs de descarga están en data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "nano-banana-2-lite",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Otros estados

Con processing o failed, data.data es null. Este ejemplo muestra failed: solo failed incluye failed_reason. Continúa consultando con processing; detente con failed.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "nano-banana-2-lite",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Consumo de créditos

Créditos consumidos por una solicitud que genera una imagen.

Créditos consumidos por una solicitud que genera una imagen.
Generación	Créditos por solicitud
Una imagen	18

Envía explícitamente los parámetros input indicados para usar la tarifa correspondiente. Las solicitudes que generan varias imágenes pueden consumir más créditos.

El campo credits de la respuesta de POST /api/v1/create muestra los créditos cobrados por la tarea.