aisplice

Nano Banana 2.1 Ext

GoogleGenerazione di immaginiper richiestaPrezzi a fascerisparmi il 12% rispetto al prezzo ufficiale

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.

Prezzo

$0.022/ chiamata

Endpoint

/images/tasks

Modalità di consegna

Ciclo di vita dei task asincroni

Disponibilità

Disponibile ora

Documentazione API

Configura e copia la richiesta

Scegli le opzioni accettate da questo modello. Il codice qui sotto si aggiorna mentre scegli.

Passo per passo nella documentazione
POSThttps://www.aisplice.store/v1/images/tasksBearer API keyTask asincrono

OpzioniVengono mostrate solo le opzioni pubblicate per questo modello.

# 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. 1Invia il task
  2. 2Interroga lo stato
  3. 3Recupera il contenuto

In produzione sono consigliati URL pubblici per i media. Carica prima un file locale, poi inserisci public_url nella richiesta al modello. Evita corpi Base64 di grandi dimensioni.

Leggi la guida all'upload

Riferimento dei parametri

model
stringobbligatorio

Identificatore esatto del modello per questa richiesta.

gemini-nano-banana-2.1-ext
prompt
stringobbligatorio

Istruzione che descrive il risultato desiderato.

size
stringfacoltativo

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
stringfacoltativo

Risoluzione dell'output richiesta.

1K2K4K
n
integerfacoltativo
1
images
string[]facoltativo

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

Ciclo di vita della risposta

Stato del task, stati finali ed esempi di risposta con il risultato.

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

In attesa

queued · submitted · in_progress · processing

Successo

completed · succeeded · success

Errore

failed · failure · cancelled · canceled

Errori e produzione

Regole di retry, idempotenza e la checklist minima per la produzione.

400 / 422

Correggi i campi della richiesta o l'opzione non supportata; non riprovare senza modifiche.

401

Verifica che la chiave API sia presente, attiva e inviata come Bearer token.

402

Il saldo dell'account è insufficiente.

409

La Idempotency-Key è in elaborazione oppure è stata riutilizzata con un corpo diverso.

429

Applica un backoff secondo Retry-After prima di riprovare.

5xx

Riprova con backoff esponenziale e mantieni la Idempotency-Key originale.

  • Per le app mobile e browser pubbliche, tieni le chiavi API sul tuo server.
  • Imposta una Idempotency-Key univoca per ogni operazione asincrona fatturabile.
  • Salva task_id, così il polling può riprendere dopo un riavvio.
  • Usa un timeout per ogni richiesta HTTP e riporta l'ID richiesta nelle segnalazioni all'assistenza.
  • Leggi i metadati dei modelli in tempo reale invece di inserire nel codice prezzi e opzioni supportate.

Prezzo e fasce

risparmi il 12% rispetto al prezzo ufficiale

Prezzo per richiesta

$0.022/ chiamata

$0.025

Prezzi a fasce

Prezzo base $0.022

Prezzi a fasce — il prezzo finale dipende dalle opzioni richieste. Le fasce non elencate vengono fatturate al prezzo base.

DimensionePrezzo
  • 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
RisoluzionePrezzo
  • 1k×1$0.022
  • 2k×1.25$0.0275
  • 4k×1.5$0.033

Il prezzo mostrato qui è esattamente quello che ti viene addebitato — le chiamate non riuscite vengono rimborsate automaticamente.

Modelli correlati