aisplice

Per funzionalità

Video

I video vengono sempre eseguiti come task: invia, poi controlla più tardi o ricevi una callback. Clip più lunghe e più nitide costano di più.

#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/videos/{task_id}

GET https://www.aisplice.store/v1/videos/{task_id}/content

Durata e risoluzione determinano la fascia di prezzo. Un task in esecuzione può essere annullato; vedi il riferimento API.

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.
  • Immagine o video di riferimento rifiutato: deve essere un URL pubblico che il modello possa scaricare.
  • 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 →

#Primo e ultimo fotogramma, immagini e video di riferimento

I modelli che li accettano mostrano i campi al passaggio 2: primo fotogramma, ultimo fotogramma, immagini di riferimento o un video di riferimento. Passa URL pubblici; carica prima i file locali.

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. Definisce la scena o la direzione del movimento.
    Valore predefinito consigliato
    Obbligatorio nella UI.
    Perché conta
    Senza di esso, gli utenti non possono guidare l'intento della clip.
  • image / images
    Quando mostrarlo
    Mostralo solo per prodotti basati su riferimenti o da immagine a video.
    Valore predefinito consigliato
    Nascondilo nei flussi solo prompt.
    Perché conta
    Cambia la modalità di creazione e dovrebbe essere una scelta di prodotto consapevole.
  • duration
    Quando mostrarlo
    Mostralo quando il flusso asincrono di base è stabile e il prezzo è visibile.
    Valore predefinito consigliato
    Parti dalla durata più breve supportata.
    Perché conta
    È uno dei maggiori moltiplicatori di costo e latenza nella generazione video.
  • resolution
    Quando mostrarlo
    Mostralo quando i clienti confrontano esplicitamente output a 720p, 1080p o 4K.
    Valore predefinito consigliato
    Scegli una risoluzione consigliata lato server.
    Perché conta
    Una risoluzione più alta aumenta costo, tempo in coda e rischio di errore.
  • webhook_url / webhook_secret
    Quando mostrarlo
    Mostralo solo agli integratori backend, non ai normali utenti finali.
    Valore predefinito consigliato
    Nei prodotti con UI preferisci il polling.
    Perché conta
    Servono all'integrazione di sistema, non alla creatività dell'utente finale, quindi devono restare fuori dai controlli rivolti al pubblico.
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.

PrecedenteImmaginiSuccessivoMusica