Audio

Suno V5

L'API Suno genera musica pronta per lo studio da prompt, stili e testi, restituendo due tracce per ogni esecuzione con consegna asincrona ottimizzata per la produzione.

$0.12 / generation

2 tracce per esecuzioneV4 / V4.5 / V5Modalità testo personalizzatoMP3 + copertina

Caricamento dell'area di lavoro...

Endpoint

POSThttps://api.apixo.ai/api/v1/generateTask/sunoCrea attività

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}Stato del polling

Autenticazione

Verifica accesso API...

Accedi per riscattare crediti gratuiti, testare il Playground e procedere con l'integrazione API.

Corpo della richiesta

request_type

async

Usa la callback con callback_url per i webhook.

provider

official

Corrisponde al manuale di Seedance 2.0.

input

oggetto

Modalità, prompt, riferimenti, dimensioni, durata e impostazioni audio.

Parametri

request_typerichiesto

Tiposelect

Usi l'asincrono per eseguire il polling di statusTask, oppure callback per ricevere un webhook quando il risultato è pronto.async · callback

callback_urlcondizionale

Tipotext

URL HTTPS pubblico per la consegna del callback.Solo in request_type=callback

moderichiesto

Tiposelect

Scegli la versione del backend di generazione.V5 · V4_5 · V4_5ALL · V4_5PLUS · V4

customModerichiesto

Tipoboolean

Abilita la modalità testo personalizzato. Quando disattivata, viene utilizzata la modalità di descrizione della canzone solo tramite prompt.

titlerichiesto

Tipotext

Obbligatorio quando la Modalità Personalizzata è attiva.Solo in customMode=

stylerichiesto

Tipostring

Descrivi genere, mood, strumentazione e stile vocale. Obbligatorio in Modalità personalizzata.Solo in customMode=

promptopzionale

Tipostring

Descrizione del brano o testo. La modalità personalizzata supporta testi più lunghi nelle versioni più recenti di Suno.

songDescriptionrichiesto

Tipostring

Campo della modalità solo-prompt utilizzato quando la Modalità Personalizzata è disattivata.Solo in customMode=

instrumentalrichiesto

Tipoboolean

Attiva per generare una traccia strumentale senza voce.

negativeTagscondizionale

Tipostring

Descrivi artefatti o stili da evitare.Solo in customMode=

styleWeightcondizionale

Tiposlider

Intensità con cui seguire la descrizione dello stile.Solo in customMode=

weirdnessConstraintcondizionale

Tiposlider

Valori più alti generano output più sperimentali.Solo in customMode=

audioWeightcondizionale

Tiposlider

Bilancia la fedeltà audio e il controllo del testo.Solo in customMode=

vocalGendercondizionale

Tiposelect

Preferenza timbro vocale (best-effort).f · mSolo in customMode=

Parametro	Tipo	Richiesto	Descrizione
`request_type`	select	richiesto	Usi l'asincrono per eseguire il polling di statusTask, oppure callback per ricevere un webhook quando il risultato è pronto.async · callback
`callback_url`	text	condizionale	URL HTTPS pubblico per la consegna del callback.Solo in request_type=callback
`mode`	select	richiesto	Scegli la versione del backend di generazione.V5 · V4_5 · V4_5ALL · V4_5PLUS · V4
`customMode`	boolean	richiesto	Abilita la modalità testo personalizzato. Quando disattivata, viene utilizzata la modalità di descrizione della canzone solo tramite prompt.
`title`	text	richiesto	Obbligatorio quando la Modalità Personalizzata è attiva.Solo in customMode=
`style`	string	richiesto	Descrivi genere, mood, strumentazione e stile vocale. Obbligatorio in Modalità personalizzata.Solo in customMode=
`prompt`	string	opzionale	Descrizione del brano o testo. La modalità personalizzata supporta testi più lunghi nelle versioni più recenti di Suno.
`songDescription`	string	richiesto	Campo della modalità solo-prompt utilizzato quando la Modalità Personalizzata è disattivata.Solo in customMode=
`instrumental`	boolean	richiesto	Attiva per generare una traccia strumentale senza voce.
`negativeTags`	string	condizionale	Descrivi artefatti o stili da evitare.Solo in customMode=
`styleWeight`	slider	condizionale	Intensità con cui seguire la descrizione dello stile.Solo in customMode=
`weirdnessConstraint`	slider	condizionale	Valori più alti generano output più sperimentali.Solo in customMode=
`audioWeight`	slider	condizionale	Bilancia la fedeltà audio e il controllo del testo.Solo in customMode=
`vocalGender`	select	condizionale	Preferenza timbro vocale (best-effort).f · mSolo in customMode=

Esempio (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "V5",
      "customMode": true,
      "instrumental": false,
      "title": "Neon Freeway Nights",
      "style": "Synthwave, dreamy pop",
      "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful."
    }
  }'

Documentazione API completa

Guida all'API Suno V5

API Suno per workflow di generazione audio

Usi Suno tramite APIXO per testare i prompt nel Playground, esaminare le demo, confrontare i prezzi e portare le stesse impostazioni nelle chiamate API di produzione.

Flusso di lavoro Suno V5

Crea e distribuisci workflow API di Suno V5 da un'unica pagina

Questa landing page per Suno V5 è pensata per i team che desiderano valutare la qualità dell'output, confrontare i prezzi, creare chiavi API e trasferire le impostazioni testate nel codice di produzione dallo stesso flusso di lavoro.

Test dei prompt con Suno V5

Usi il Playground di Suno V5 per testare prompt, scelte di modalità e impostazioni di output prima di portare una richiesta in produzione.

Revisione della demo di Suno V5

Ispeziona prima l{outputLabel} reale o segnaposto, poi carica gli stessi parametri demo nel Playground per uniterazione più rapida.

Passaggio all'API Suno V5

Passa dai test visivi a chiavi API, esempi cURL, JSON di richiesta e documentazione, senza lasciare la pagina di questo modello.

Trasparenza dei prezzi di Suno V5

Confronta i livelli di prezzo disponibili sulla stessa pagina prima di scegliere un profilo di costo per i job di produzione.

Controllo dell'input di Suno V5

Modifica testo, stile e controlli vocali direttamente nel Playground in modo che il modulo testato corrisponda alla superficie API documentata.

Pronto per la produzione con Suno V5

Usi APIXO quando il polling asincrono, la delivery via callback, la cronologia delle generazioni e una fatturazione prevedibile sono importanti per i workflow del team.

Panoramica del modello

Che cos’è l’API di Suno?

Suno è disponibile tramite APIXO come API di produzione per generazione audio. La pagina del modello combina test nel Playground, parametri di richiesta reali, prezzi e passaggio alla documentazione in un unico workflow.

Utilizzi questa pagina per convalidare prima i prompt e le scelte di modalità, quindi mantenga le stesse impostazioni per chiavi API, esempi cURL, integrazione backend e job di generazione ripetibili.

Workflow dell'API Suno per team di produzione

Inizi dal Playground e scelga la modalità che corrisponde ai suoi asset di input.
Esamina gli output di esempio e carica i parametri della demo quando hai bisogno di una base di partenza rapida.
Controlla i prezzi prima di inviare batch di grandi dimensioni o lavori a risoluzione più alta.
Usi il polling asincrono per una UX interattiva o la modalità callback per le code backend.

Specifiche tecniche dell'API Suno

Funzionalità attuali dell'API Suno e vincoli rilevanti per l'integrazione.

Modalità di Suno

Solo prompt, testo personalizzato e musica strumentale

Output di Suno

2 tracce per esecuzione

Controlli di Suno

V4 / V4.5 / V5 / Modalità testo personalizzato

Latenza di Suno

Tipicamente 60-90 secondi

Funzionalità principali di Suno V5

Generazione musicale Suno

Genera output audio da prompt strutturati, mantenendo visibili le impostazioni di generazione per il passaggio all'API.

Controllo creativo di Suno

Modifica testi, stile o impostazioni di modalità direttamente nel Playground prima di passare alle chiamate di produzione.

Workflow dell'API Suno

Usi la creazione asincrona dei task, il polling, la delivery via callback e gli esempi di richiesta dalla stessa pagina del modello.

Cosa può creare con Suno V5?

Strumenti per creator di Suno

Aggiungi la generazione musicale ai workflow dei creator dove gli utenti necessitano di un'iterazione rapida da prompt ad audio.

Audio di brand Suno

Genera tracce per campagne, musica di sottofondo di breve durata, intro, outro o concept sonori tramite job API.

Automazione della produzione Suno

Esegui job audio asincroni e ripetibili dalle code di backend, monitorando input, ID dei task e URL dei risultati.

Note e limitazioni di Suno V5

La generazione con Suno utilizza la consegna asincrona delle attività; i sistemi di produzione dovrebbero supportare il polling o la gestione dei callback.
La qualità del risultato dipende dalla chiarezza del prompt, dalla qualità degli asset di input e dal comportamento del modello lato provider.
Tutte le richieste devono superare i controlli di sicurezza, moderazione e accesso all'account del fornitore.
Gli output audio possono variare in testo, stile vocale, tempistica e mix anche quando viene utilizzata la stessa struttura di prompt.

Domande frequenti su Suno V5

Inizia a costruire

Prova il playground qui sopra, poi passa alla documentazione API quando sei pronto per l'integrazione.

Prova il playground Visualizza documentazione API

API Suno per workflow di generazione audio

Crea e distribuisci workflow API di Suno V5 da un'unica pagina

Che cos’è l’API di Suno?

Workflow dell'API Suno per team di produzione

Specifiche tecniche dell'API Suno

Modalità di Suno

Output di Suno

Controlli di Suno

Latenza di Suno

Funzionalità principali di Suno V5

Generazione musicale Suno

Controllo creativo di Suno

Workflow dell'API Suno

Cosa può creare con Suno V5?

Strumenti per creator di Suno

Audio di brand Suno

Automazione della produzione Suno

Note e limitazioni di Suno V5

Domande frequenti su Suno V5

Posso testare Suno prima di scrivere il codice API?

Suno supporta la generazione asincrona?

Da dove provengono i parametri di Suno?

Posso sostituire gli asset demo in un secondo momento?

Inizia a costruire