Nano Banana 2.1 Ext
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.022/ 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.
https://www.aisplice.store/v1/images/tasksBearer API keyTarea asíncronaOpcionesSolo 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 .- 1Envía la tarea
- 2Consulta el estado
- 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 subidaReferencia de parámetros
modelIdentificador exacto del modelo para esta solicitud.
gemini-nano-banana-2.1-extpromptInstrucción que describe el resultado deseado.
sizeOutput 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:1resolutionResolución de salida solicitada.
1K2K4Kn1imagesOptional 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.
Ciclo de vida de la respuesta
Estado de la tarea, estados finales y ejemplos de respuesta del resultado.
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "image.task",
"model": "Nano Banana 2.1 Ext",
"status": "queued"
}{
"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.
Errores y producción
Reglas de reintento, idempotencia y la lista mínima para producción.
400 / 422Corrige los campos de la solicitud o la opción no admitida; no reintentes sin cambios.
401Comprueba que la clave de API esté presente, activa y se envíe como Bearer token.
402El saldo de la cuenta es insuficiente.
409La Idempotency-Key se está procesando o se reutilizó con otro cuerpo.
429Aplica backoff según Retry-After antes de reintentar.
5xxReintenta 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 12% frente al oficialPrecio por solicitud
$0.022/ llamada
$0.025
Precios por niveles
Precio base $0.022
Precios por niveles — el precio final depende de las opciones que solicites. Los niveles no listados se facturan al precio base.
- 16:9×1$0.022
- 1:1×1$0.022
- 1:4×1$0.022
- 1:8×1$0.022
- 21:9×1$0.022
- 2:3×1$0.022
- 3:2×1$0.022
- 3:4×1$0.022
- 4:1×1$0.022
- 4:3×1$0.022
- 4:5×1$0.022
- 5:4×1$0.022
- 8:1×1$0.022
- 9:16×1$0.022
- auto×1$0.022
- 1k×1$0.022
- 2k×1.25$0.0275
- 4k×1.5$0.033
El precio que ves aquí es exactamente lo que se te factura — las llamadas fallidas se reembolsan automáticamente.
Modelos relacionados