aisplice

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.

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 .

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

Tutti i parametri

Tutti i campi accettati da questo modello, con i valori consentiti.

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

Tutti i campi: /v1/images/tasks nel riferimento API →

#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

Un task fallito o annullato viene rimborsato automaticamente. Il registro delle richieste mostra il costo finale di ogni task.

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.

Cerca qualsiasi altro errore →

#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.

Come caricare un file locale →

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.
recommended-rollout.txt
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 tuning

Una sola fonte di verità per i risultati

Quando un task termina, basa la tua app sull'URL della piattaforma restituito da /content. Così i dettagli del fornitore upstream restano nascosti e la riproduzione dello storico è stabile.

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.