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 / use

2 tracce per esecuzioneWorkflow asincronoControllo del prompt e dei testiMP3 + copertina

Parametri

Model Version*

Custom Mode*

Abilitato

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

Disabilitato

Vocal Gender Preference

Output

Il contenuto generato apparirà qui

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

Use async to poll or callback to receive a webhook when ready.async · callback

callback_urlcondizionale

Tipotext

Publicly accessible URL for callback mode.Solo in request_type=callback

moderichiesto

Tiposelect

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customModerichiesto

Tipoboolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

titlerichiesto

Tipotext

Appears in metadata and can steer theme. Required when Custom Mode is on.Solo in customMode=

stylerichiesto

Tipostring

Describe genre/mood/instrumentation. Required in Custom Mode.Solo in customMode=

promptcondizionale

Tipostring

Provide full lyrics for sung output. Required when Instrumental is off.Solo in customMode=

songDescriptionrichiesto

Tipostring

Simple mode: one field to steer both style and topic when Custom Mode is off.Solo in customMode=

instrumentalrichiesto

Tipoboolean

Turn on to generate backing track without vocals.

negativeTagscondizionale

Tipostring

Negative TagsSolo in customMode=

styleWeightcondizionale

Tiposlider

How strongly to follow the Style description.Solo in customMode=

weirdnessConstraintcondizionale

Tiposlider

Push creativity/experimentation. Higher = wilder.Solo in customMode=

audioWeightcondizionale

Tiposlider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.Solo in customMode=

vocalGendercondizionale

Tiposelect

Best-effort vocal timbre preference (custom mode only).f · mSolo in customMode=

Parametro	Tipo	Richiesto	Descrizione
`request_type`	select	richiesto	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	condizionale	Publicly accessible URL for callback mode.Solo in request_type=callback
`mode`	select	richiesto	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	richiesto	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	richiesto	Appears in metadata and can steer theme. Required when Custom Mode is on.Solo in customMode=
`style`	string	richiesto	Describe genre/mood/instrumentation. Required in Custom Mode.Solo in customMode=
`prompt`	string	condizionale	Provide full lyrics for sung output. Required when Instrumental is off.Solo in customMode=
`songDescription`	string	richiesto	Simple mode: one field to steer both style and topic when Custom Mode is off.Solo in customMode=
`instrumental`	boolean	richiesto	Turn on to generate backing track without vocals.
`negativeTags`	string	condizionale	Negative TagsSolo in customMode=
`styleWeight`	slider	condizionale	How strongly to follow the Style description.Solo in customMode=
`weirdnessConstraint`	slider	condizionale	Push creativity/experimentation. Higher = wilder.Solo in customMode=
`audioWeight`	slider	condizionale	Balance audio vs lyrical fidelity. Higher favors audio fidelity.Solo in customMode=
`vocalGender`	select	condizionale	Best-effort vocal timbre preference (custom mode only).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",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

Documentazione API completa

Esempi di output

Generato con l'API Suno V5 su APIXO

2 Tracce

Neon Freeway Nights

Visualizza

Guida completa

Cos'è l'API Suno?

L'API Suno è un'interfaccia di generazione testo a musica progettata per flussi di lavoro di produzione rapidi. Può trasformare prompt, tag di stile e testi personalizzati in due brani completi con relative immagini di copertina.

Questo lo rende adatto per strumenti per creator, generazione di contenuti brandizzati e casi d'uso di produzione musicale automatizzata dove l'iterazione rapida conta più della composizione manuale.

Come funziona il flusso di lavoro della generazione

Invia una richiesta di generazione con parametri solo prompt o modalità testo personalizzato.
Ricevi lo stato dell'attività in modo asincrono tramite polling o endpoint di callback.
In caso di successo, consuma due tracce generate più i relativi metadati dell'artwork.

Specifiche tecniche API Suno

Caratteristiche operative rilevanti per l'integrazione del prodotto e del backend.

Output

2 tracce per generazione

Superficie di controllo

Stile, stranezza, peso audio

Modalità di generazione

Modalità solo prompt e testi personalizzati

Consegna

Polling asincrono o callback

Funzionalità chiave

Output a doppia traccia

Ogni generazione restituisce due varianti di brani, accelerando la selezione A/B e l'iterazione creativa per i team di produzione.

Slider di controllo creativo

Regola il peso dello stile, la stranezza (weirdness) e il peso dell'audio per passare da tracce commerciali sicure a texture sperimentali.

Flussi di lavoro per testi e voci

Supporta la generazione solo tramite prompt e la modalità testo personalizzato con preferenze opzionali per strumentale e genere vocale.

Pronto per l'integrazione asincrona

Funziona con strategie di polling o callback, facilitando l'integrazione nei workflow backend basati su code.

Cosa puoi costruire?

Generazione musicale in-app

Genera snippet musicali brandizzati e tracce adatte ai creator per UGC, video brevi e strumenti di creazione social.

Branding per Podcast e Video

Produca tracce intro e outro, bumper e motivi a tema ricorrenti con mood e ritmo controllabili.

Colonne sonore per contenuti brevi

Crea musica di sottofondo personalizzata per TikTok, Shorts e Reels con iterazioni rapide su stile e hook dei testi.

Audio per giochi e interattivo

Prototipi loop ambientali, temi per menu e idee per colonne sonore leggere per giochi ed esperienze interattive.

Note e limitazioni

Ogni generazione restituisce esattamente due tracce; il numero di output non può essere personalizzato.
Il flusso di lavoro del Playground è async-first; l'orchestrazione delle callback è disponibile a livello API.
La lunghezza del prompt/testo nella modalità personalizzata è limitata a 5.000 caratteri nelle versioni supportate.
Il genere vocale e le caratteristiche vocali sono controlli basati sul miglior sforzo (best-effort), non garanzie assolute.

Domande frequenti

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

Suno V5

Esempi di output

Cos'è l'API Suno?

Come funziona il flusso di lavoro della generazione

Specifiche tecniche API Suno

Output

Superficie di controllo

Modalità di generazione

Consegna

Funzionalità chiave

Output a doppia traccia

Slider di controllo creativo

Flussi di lavoro per testi e voci

Pronto per l'integrazione asincrona

Cosa puoi costruire?

Generazione musicale in-app

Branding per Podcast e Video

Colonne sonore per contenuti brevi

Audio per giochi e interattivo

Note e limitazioni

Domande frequenti

Posso generare solo una traccia invece di due?

Posso forzare l'output esatto del testo della canzone?

Questa API è sincrona?

Quale tipo di file viene restituito?

Inizia a costruire