Nano Banana 2.1 Ext

GoogleGeneración de imágenespor solicitudPrecios por nivelesahorra un 48% frente al oficial

Nano Banana 2.1 Ext asynchronous image generation and editing: one image per request at a fixed price per resolution (1K/2K/4K), same output quality as Nano Banana 2.1, up to 14 reference images. 1:4, 4:1, 1:8 and 8:1 are available only at 1K.

Precio

$0.013/ llamada

Endpoint

/images/tasks

Modo de entrega

Ciclo de vida de las tareas asíncronas

Disponibilidad

Disponible ahora

Documentación de la API

Configura y copia la solicitud

Elige las opciones que acepta este modelo. El código de abajo se actualiza según lo que elijas.

Paso a paso en la documentación
POSThttps://www.aisplice.store/v1/images/tasksBearer API keyTarea asíncrona

OpcionesSolo se muestran las opciones publicadas para este modelo.

# Requires curl and jq
API_KEY="${API_KEY:-YOUR_API_KEY}"

# 1. Submit once
SUBMITTED=$(curl --fail-with-body -sS https://www.aisplice.store/v1/images/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: model-docs-$(date +%s)-$$" \\
  -d '{
  "model": "Nano Banana 2.1 Ext",
  "prompt": "A cinematic scene with careful composition",
  "size": "auto",
  "resolution": "1K",
  "n": 1
}')
TASK_ID=$(printf '%s' "$SUBMITTED" | jq -r '.task_id // .id // empty')
if [ -z "$TASK_ID" ]; then
  printf '%s\n' "$SUBMITTED" >&2
  exit 1
fi
echo "task_id=$TASK_ID"

# 2. Poll until terminal
while true; do
  STATUS_JSON=$(curl --fail-with-body -sS \
    "https://www.aisplice.store/v1/images/tasks/$TASK_ID" \
    -H "Authorization: Bearer $API_KEY")
  STATUS=$(printf '%s' "$STATUS_JSON" | jq -r '.status // empty' | tr '[:upper:]' '[:lower:]')
  echo "status=$STATUS"
  case "$STATUS" in
    completed|succeeded|success) break ;;
    failed|failure|cancelled|canceled)
      printf '%s\n' "$STATUS_JSON" | jq .
      exit 1
      ;;
  esac
  sleep 3
done

# 3. Fetch the final result
curl --fail-with-body -sS \
  "https://www.aisplice.store/v1/images/tasks/$TASK_ID/content" \
  -H "Authorization: Bearer $API_KEY" | jq .
  1. 1Envía la tarea
  2. 2Consulta el estado
  3. 3Obtén el contenido

Se recomiendan URL públicas de medios para producción. Sube primero un archivo local y luego pon public_url en la solicitud al modelo. Evita cuerpos Base64 grandes.

Leer la guía de subida

Referencia de parámetros

model
stringobligatorio

Identificador exacto del modelo para esta solicitud.

gemini-nano-banana-2.1-ext
prompt
stringobligatorio

Instrucción que describe el resultado deseado.

size
stringopcional

Output aspect ratio. 1:4, 4:1, 1:8 and 8:1 require 1K. auto follows the reference image when one is given.

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

Resolución de salida solicitada.

1K2K4K
n
integeropcional
1
images
string[]opcional

Optional reference images (URLs or data URIs), up to 14, 20 MB each and 50 MB in total.

Ciclo de vida de la respuesta

Estado de la tarea, estados finales y ejemplos de respuesta del resultado.

Enviar
{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "image.task",
  "model": "Nano Banana 2.1 Ext",
  "status": "queued"
}
Contenido
{
  "created": 1720000000,
  "data": [
    {
      "url": "https://media.example/result.png"
    }
  ]
}

En espera

queued · submitted · in_progress · processing

Éxito

completed · succeeded · success

Fallo

failed · failure · cancelled · canceled

Errores y producción

Reglas de reintento, idempotencia y la lista mínima para producción.

400 / 422

Corrige los campos de la solicitud o la opción no admitida; no reintentes sin cambios.

401

Comprueba que la clave de API esté presente, activa y se envíe como Bearer token.

402

El saldo de la cuenta es insuficiente.

409

La Idempotency-Key se está procesando o se reutilizó con otro cuerpo.

429

Aplica backoff según Retry-After antes de reintentar.

5xx

Reintenta con backoff exponencial y conserva la Idempotency-Key original.

  • En apps públicas móviles y de navegador, mantén las claves de API en tu servidor.
  • Define una Idempotency-Key única para cada operación asíncrona facturable.
  • Guarda task_id para que la consulta pueda reanudarse tras un reinicio.
  • Usa un timeout en cada solicitud HTTP e incluye el ID de solicitud en los reportes a soporte.
  • Lee los metadatos de los modelos en vivo en lugar de fijar en el código los precios y las opciones admitidas.

Precio y niveles

ahorra un 48% frente al oficial

Precio por solicitud

$0.013/ llamada

$0.025

Precios por niveles

Precio base $0.013

Precios por niveles — el precio final depende de las opciones que solicites. Los niveles no listados se facturan al precio base.

TamañoPrecio
  • 16:9×1$0.013
  • 1:1×1$0.013
  • 1:4×1$0.013
  • 1:8×1$0.013
  • 21:9×1$0.013
  • 2:3×1$0.013
  • 3:2×1$0.013
  • 3:4×1$0.013
  • 4:1×1$0.013
  • 4:3×1$0.013
  • 4:5×1$0.013
  • 5:4×1$0.013
  • 8:1×1$0.013
  • 9:16×1$0.013
  • auto×1$0.013
ResoluciónPrecio
  • 1k×1$0.013
  • 2k×1.166666666667$0.015167
  • 4k×1.5$0.0195

El precio que ves aquí es exactamente lo que se te factura — las llamadas fallidas se reembolsan automáticamente.

Modelos relacionados