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-2.5-flash-image-preview$0.0125 / 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",
  "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-2.5-flash-image-preview
prompt
stringobbligatorio

Istruzione che descrive il risultato desiderato.

size
stringfacoltativo

Proporzioni o dimensioni dell'output.

auto1:12:33:23:44:34:55:49:1616:921:9
resolution
stringfacoltativo

Risoluzione dell'output richiesta.

1K
n
integerfacoltativo
images
string[]facoltativo

Optional reference images, up to 14.

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",
  "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.