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 Mini 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-mini/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-mini/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 Mini
Quanto costa l’API di Suno v6 Mini?
Suno v6 Mini 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 Mini nell’API?
Inserisci suno/v6-mini/text-to-audio per Musica nel campo model di POST /jobs/createTask.
Che cos’è v6 Mini?
Suno descrive v6 Mini come una versione più veloce ed efficiente di v6, che rende più facile trasformare un’idea in un brano, e dice che è la versione disponibile per tutti. È uscito il 9 settembre 2026 insieme a v6 e v6 Wild.
La gestione del testo è la stessa di v6?
Nei nostri test sì: tutti e tre hanno cantato parola per parola, in ordine, lo stesso testo pulito di 11 righe, con i tag di sezione lasciati muti. Non abbiamo messo in classifica il loro suono.
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 maschile calda. 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 una frase è tornato come brano solista nel nostro test.
Quali sono i limiti dell’API di Suno v6 Mini?
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 Mini senza scrivere codice?
Sì. Il Playground esegue Suno v6 Mini con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
