Per funzionalità
Immagini
Scegli un modello, copia la richiesta, ottieni l'immagine. Tutto ciò che segue si adatta al modello scelto.
#1. Scegli un modello
gemini-nano-banana-2.1-ext$0.022 / richiestaTask asincronoLimiti e stato
12 modelli online per questa funzione. Se cambi modello, il codice qui sotto si aggiorna.
#2. Copia la richiesta
Sostituisci YOUR_API_KEY con la tua chiave, poi eseguila. Le opzioni mostrate sono quelle accettate da questo modello.
https://www.aisplice.store/v1/images/tasksBearer API keyTask asincronoOpzioniVengono 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 .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'uploadTutti i parametri
Tutti i campi accettati da questo modello, con i valori consentiti.
Tutti i parametri
Tutti i campi accettati da questo modello, con i valori consentiti.
modelIdentificatore esatto del modello per questa richiesta.
gemini-nano-banana-2.1-extpromptIstruzione che descrive il risultato desiderato.
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:1resolutionRisoluzione dell'output richiesta.
1K2K4Kn1imagesOptional 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.
Ciclo di vita della risposta
Stato del task, stati finali ed esempi di risposta con il risultato.
{
"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"
}
]
}In attesa
queued · submitted · in_progress · processing
Successo
completed · succeeded · success
Errore
failed · failure · cancelled · canceled
#3. Ottieni il risultato
La chiamata di invio risponde subito con un task_id. Controlla il task a intervalli di pochi secondi finché status non è completed, oppure passa webhook_url e ti chiameremo noi quando avrà finito.
GET https://www.aisplice.store/v1/images/tasks/{task_id}
GET https://www.aisplice.store/v1/images/tasks/{task_id}/content
Addebitato solo in caso di successo
Valori di stato e polling →Ricevi una callback invece di controllare →
#Quando qualcosa va storto
- 400 con il nome di un campo: quell'opzione non è accettata da questo modello; usa i valori elencati al passaggio 2.
- Contenuto rifiutato dal modello: riformula il prompt; le richieste rifiutate non vengono addebitate.
- 402: il saldo non copre questa richiesta; ricarica in Portafoglio, poi riprova.
- 429: rallenta e riprova dopo i secondi indicati da Retry-After.
- 503 model_not_found: il nome del modello è errato o il modello è offline; scegline uno al passaggio 1.
#Immagini di riferimento
Passa URL pubblici di immagini nel campo dell'immagine di riferimento indicato al passaggio 2. Per un file locale, caricalo prima e usa l'URL che ricevi.
Integrarlo nel tuo prodottoQuali opzioni mostrare per prime ai tuoi utenti e quali lasciare per dopo.
Quali opzioni mostrare per prime ai tuoi utentiInizia con il prompt e un solo parametro di prezzo; aggiungi il resto quando il flusso di base funziona.+
Intento creativo
Campi come prompt vanno nella UI perché l'utente capisce direttamente il risultato che modificano.
Moltiplicatore di costo
Campi come durata, risoluzione, dimensione e numero vanno introdotti solo quando il prezzo è già spiegabile.
Cambio di modalità
Campi come immagine, maschera o ID di continuazione cambiano il flusso stesso e dovrebbero comparire solo in modalità dedicate.
Infrastruttura di sistema
Campi come webhook_secret sono per gli integratori, non per i creator di tutti i giorni, quindi tienili fuori dalla UI predefinita.
prompt- Quando mostrarlo
- Sempre. È l'input creativo principale per i task di immagini.
- Valore predefinito consigliato
- Obbligatorio nella UI.
- Perché conta
- Controlla direttamente il risultato; nasconderlo rende la funzione inutilizzabile.
size- Quando mostrarlo
- Mostralo dalla prima versione se la fatturazione cambia in base alle dimensioni dell'output.
- Valore predefinito consigliato
- Parti da una sola proporzione consigliata, come 1:1.
- Perché conta
- Influisce sia sul costo sia sulla composizione dell'output, quindi agli utenti serve subito una scelta semplice della dimensione.
quality- Quando mostrarlo
- Mostralo solo quando gli utenti chiedono chiaramente un livello più alto o più economico.
- Valore predefinito consigliato
- Lascialo lato server al valore predefinito del modello.
- Perché conta
- Cambia prezzo e latenza, ma di solito non serve come controllo fin dal primo giorno.
n- Quando mostrarlo
- Mostralo solo quando la generazione in batch è un flusso centrale.
- Valore predefinito consigliato
- Predefinito: 1.
- Perché conta
- Moltiplica subito il costo e può rendere confusa la prima esperienza d'uso.
mask / image- Quando mostrarlo
- Mostralo solo per prodotti di modifica o con immagini di riferimento.
- Valore predefinito consigliato
- Nascondilo nella modalità da testo a immagine.
- Perché conta
- Questi campi trasformano il prodotto da generazione a modifica, quindi non devono finire nel flusso di base.
Phase 1
- prompt
- one size or one duration default
- submit -> poll -> content
Phase 2
- one quality or resolution selector
- clear pricing hint
Phase 3
- advanced controls such as reference media, continuation, webhook, or vendor-specific tuningUna sola fonte di verità per i risultati
Non hai ancora risolto?
Inviaci l'ID richiesta o il messaggio di errore e verificheremo.