Modelli supportati
Modelli di generazione disponibili
Le richieste usano solo i nomi di modello della piattaforma elencati qui sotto.
| Nome del modello | Nome visualizzato | Uso | Stato |
|---|---|---|---|
suno-v6 |
Suno V6 | Modello di generazione predefinito | Disponibile |
suno-v6-wild |
Suno V6 Wild | Variante Wild del V6 | Disponibile |
suno-v6-mini |
Suno V6 Mini | Variante Mini del V6 | Disponibile |
Modello predefinito consigliato: suno-v6.
A proposito della separazione degli stem
La separazione degli stem è una funzione fissa e indipendente: non serve scegliere un modello
di generazione. Basta inviare il brano originale e la modalità di separazione (per esempio
two o twelve). Il numero di tracce restituite è quello indicato dalla risposta.
Il parametro model
Negli endpoint di generazione model è di norma opzionale:
- Omesso: usa il valore predefinito
suno-v6. - Indicato: deve essere
suno-v6,suno-v6-wildosuno-v6-mini. - Sono accettati solo i nomi di modello della tabella qui sopra.
Esempio minimo di generazione
curl -X POST https://www.suno-api.io/api/music/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "una vivace canzone folk sul primo giorno di primavera",
"model": "suno-v6"
}'
Esempio con una variante del V6
{
"model": "suno-v6-wild",
"description": "un brano elettronico con struttura sperimentale"
}
Modelli disattivati
Questi modelli non accettano più nuove richieste:
suno-v2suno-v3suno-v3-5suno-v4suno-v4-5suno-v4-5-allsuno-v4-5-plussuno-v5suno-v5-5
Brani e attività vecchie possono ancora mostrare il vecchio model_name o model_version.
Si tratta di un dato storico: non significa che il vecchio modello accetti nuove richieste.
Per compatibilità con i client esistenti, una richiesta che indica un modello disattivato
viene elaborata con il modello predefinito attuale suno-v6 invece di essere rifiutata.
L'attività registra comunque suno-v6 e non viene restituito alcun errore di "modello non
disponibile". Aggiorna comunque al più presto gli esempi ai nomi attuali.
Elencare i modelli
GET /v1/models deve includere almeno questi modelli musicali:
{
"object": "list",
"data": [
{ "id": "suno-v6", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
]
}
La risposta può contenere anche modelli per i testi, rotte di compatibilità o modelli interni. Non confonderli con i modelli V6 di generazione musicale.
Scegliere la variante del V6
Nella maggior parte delle integrazioni il modello predefinito è sufficiente. Le tre varianti si distinguono per fedeltà al prompt e variazione del risultato.
| Variante | Quando usarla |
|---|---|
suno-v6 |
Quando vuoi un risultato prevedibile e fedele alla descrizione. È il predefinito e la scelta giusta per la produzione. |
suno-v6-wild |
Quando vuoi più variazione e puoi confrontare più take. Utile per esplorare uno stile. |
suno-v6-mini |
Quando vuoi provare un prompt al costo minore prima di generare sul serio. |
Poiché ogni esecuzione restituisce due brani, un flusso pratico è abbozzare con
suno-v6-mini ed eseguire il prompt approvato su suno-v6 per scegliere la versione da
pubblicare.
Costo e rimborso
La tariffa è per richiesta, non per modello: ogni esecuzione costa 0,6 ¥ e restituisce due brani. Le generazioni non riuscite vengono rimborsate automaticamente, quindi un tentativo fallito non consuma saldo. I download sono illimitati e non vengono mai addebitati a parte.
Ottenere una chiave API
Dopo la registrazione puoi creare una chiave API nella console. Ogni generazione costa 0,6 ¥ e restituisce 2 brani, i download sono illimitati e non serve un numero di telefono.
Ottieni chiave API Torna alla panoramica