aisplice

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.

POSThttps://www.aisplice.store/v1/music/generationsBearer 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/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.

prompt
stringfacoltativo

Istruzione che descrive il risultato desiderato.

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": "music.task",
  "model": "Suno",
  "status": "queued"
}

In attesa

queued · submitted · in_progress · processing

Successo

completed · succeeded · success

Errore

failed · failure · cancelled · canceled

Tutti i campi: /v1/music 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/music/tasks/{task_id}

GET https://www.aisplice.store/v1/music/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 →

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