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