Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
audio_weight | No | How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only. ≥ 0 · ≤ 1 |
generate_lyrics | No | Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off. Predefinito: true |
image_urls | No | Immagini che danno il mood: la musica ne prende l’atmosfera. |
instrumental | No | Solo musica, senza voce. Predefinito: false |
lyrics | No | Scrivi il tuo testo o lascia fare al modello. |
negative_prompt | No | Stili o suoni che non vuoi nel brano. |
persona_id | No | ID of an existing Suno persona to reuse its style or voice. |
persona_model | No | Whether persona_id is a style persona or a voice persona. style_persona · voice_persona |
prompt | Sì | Describe the song: genre, mood, tempo, instruments and voice. With lyrics or an instrumental this is the style (up to 1,000 characters); with no lyrics the model writes the words from it. |
reference_audio_urls | No | Audio da riprendere: una voce, una musica o un ritmo. |
reference_video_urls | No | Un video su cui la musica deve adattarsi. |
style_weight | No | How closely to follow the style in the prompt, from 0 to 1. ≥ 0 · ≤ 1 |
title | No | Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song. |
variety | No | How different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max. ≥ 0 · ≤ 4 |
vocal_gender | No | Make a female or male lead vocal more likely. Applies with lyrics. female · male |
weirdness | No | How experimental the song may get, from 0 (conventional) to 1 (unusual). ≥ 0 · ≤ 1 |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti per generazione | ≈ USD |
|---|---|---|
| Standard | 10,8 | 0,11 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 11 crediti per generazione (0,11 USD).
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di Suno v6 in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model suno/v6/text-to-audio e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di Suno v6
Quanto costa l’API di Suno v6?
Suno v6 costa 11 crediti (0,11 USD) per generazione. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di Suno v6 nell’API?
Inserisci suno/v6/text-to-audio per Musica nel campo model di POST /jobs/createTask.
Che cosa dice Suno di v6?
Suno dice che v6 è affidabile, preciso e offre in modo costante musica rifinita in ogni genere e stile. È uscito il 9 settembre 2026 insieme a v6 Wild e v6 Mini.
Canterà esattamente il mio testo?
Nei nostri test con le impostazioni predefinite, sì. Un testo di 11 righe è stato cantato parola per parola nell’ordine scritto; i tag di sezione come [Chorus] non sono stati cantati e il ritornello non è stato ripetuto da solo.
Mi viene addebitato qualcosa se una richiesta viene rifiutata o fallisce?
No. L’importo trattenuto per la richiesta viene rilasciato per intero.
Posso scegliere chi canta?
In parte. Descrivi la voce nel brief di stile, per esempio una voce femminile sicura. Con il tuo testo o con instrumental attivo puoi anche impostare vocal_gender su female o male; è una preferenza, non una garanzia, e non abbiamo misurato quanto spesso venga rispettata. Un duetto richiesto in un’idea di una sola frase è tornato come brano solista nel nostro test, quindi indica una sola voce se per te conta.
Quali sono i limiti dell’API di Suno v6?
Immagini di riferimento: 5; Audio di riferimento: 1; Video di riferimento: 1; Lunghezza del prompt (caratteri): 3,000. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare Suno v6 senza scrivere codice?
Sì. Il Playground esegue Suno v6 con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli Suno
Suno v6 è il più affidabile per le canzoni che hai già in mente. v6 Wild prende strade più sorprendenti e materiche, e v6 Mini è il taccuino per gli schizzi veloci, tutti allo stesso prezzo per generazione.
