Per funzionalità
Musica
La musica viene eseguita come task: invia un prompt, poi controlla più tardi o ricevi una callback. Inizia con il solo prompt.
#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/music/tasks/{task_id}
GET https://www.aisplice.store/v1/music/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.
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 minimo indispensabile per la musica.
- Valore predefinito consigliato
- Obbligatorio nella UI.
- Perché conta
- Contiene il tema, il genere e la direzione emotiva.
instrumental / make_instrumental- Quando mostrarlo
- Mostralo quando il prodotto distingue chiaramente tra output vocale e strumentale.
- Valore predefinito consigliato
- Lascialo lato server, a meno che gli utenti non scelgano tra tracce vocali e strumentali.
- Perché conta
- Cambia il tipo di output e dovrebbe corrispondere a una scelta di business chiara.
title / tags- Quando mostrarlo
- Mostralo solo dopo che gli utenti hanno già capito la generazione con il solo prompt.
- Valore predefinito consigliato
- Campi avanzati facoltativi.
- Perché conta
- Aiutano a controllare lo stile, ma non devono ostacolare il primo risultato riuscito.
version / mv- Quando mostrarlo
- Mostralo solo se gli utenti devono scegliere una famiglia di modelli o una modalità di generazione.
- Valore predefinito consigliato
- Fissa una versione consigliata sul server.
- Perché conta
- Aumenta la fatica decisionale e di solito rientra nei controlli degli operatori.
continue_clip_id / continue_at- Quando mostrarlo
- Mostralo solo nei flussi di continuazione o estensione.
- Valore predefinito consigliato
- Nascondilo nei flussi di creazione standard.
- Perché conta
- Sono controlli per esperti e, se mostrati troppo presto, confondono chi li usa per la prima volta.
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.