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
suno$0.07 / richiestaLimiti e stato
1 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.
https://www.aisplice.store/v1/music/generationsBearer API keyTask asincronoOpzioniVengono 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/music/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: model-docs-$(date +%s)-$$" \\
-d '{
"model": "Suno",
"prompt": "An uplifting electronic track for a product launch",
"operation": "music",
"version": "v6",
"custom": false,
"instrumental": false
}')
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/music/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/music/tasks/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" | jq .Tutti i parametri
Tutti i campi accettati da questo modello, con i valori consentiti.
Tutti i parametri
Tutti i campi accettati da questo modello, con i valori consentiti.
promptIstruzione che descrive il risultato desiderato.
Ciclo di vita della risposta
Stato del task, stati finali ed esempi di risposta con il risultato.
Ciclo di vita della risposta
Stato del task, stati finali ed esempi di risposta con il risultato.
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "music.task",
"model": "Suno",
"status": "queued"
}In attesa
queued · submitted · in_progress · processing
Successo
completed · succeeded · success
Errore
failed · failure · cancelled · canceled
#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.