Riferimento API di Suno v6 Mini

Con una sola chiave API di PopNow chiami Suno v6 Mini dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da: Suno
Risultato: Audio
Da: 10.8 crediti per richiesta ($0.108)
ID del modello: suno/v6-mini/text-to-audio

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Musica

suno/v6-mini/text-to-audio

Prezzo

Opzione	Crediti (per richiesta)	Dollari USA
`Predefinito`	10.8	$0.108

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`prompt`Obbligatorio	`string`	—	fino a 3000 caratteri	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.
`lyrics`Facoltativo	`string`	—	fino a 5000 caratteri	Words to sing, sung in order. Section tags such as [Verse], [Chorus] and [Bridge] shape the song and are not sung.
`generate_lyrics`Facoltativo	`boolean`	`true`	—	Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off.
`instrumental`Facoltativo	`boolean`	`false`	—	Generate music with no vocals.
`title`Facoltativo	`string`	—	fino a 80 caratteri	Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song.
`negative_prompt`Facoltativo	`string`	—	fino a 500 caratteri	Styles or elements to keep out of the song.
`vocal_gender`Facoltativo	`string`	—	female, male	Make a female or male lead vocal more likely. Applies with lyrics.
`style_weight`Facoltativo	`number`	—	da 0 a 1	How closely to follow the style in the prompt, from 0 to 1.
`weirdness`Facoltativo	`number`	—	da 0 a 1	How experimental the song may get, from 0 (conventional) to 1 (unusual).
`audio_weight`Facoltativo	`number`	—	da 0 a 1	How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only.
`variety`Facoltativo	`integer`	—	da 0 a 4	How different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max.
`persona_id`Facoltativo	`string`	—	fino a 200 caratteri	ID of an existing Suno persona to reuse its style or voice.
`persona_model`Facoltativo	`string`	—	style_persona, voice_persona	Whether persona_id is a style persona or a voice persona.
`image_urls`Facoltativo	`array<string (uri)>`	—	fino a 5 elementi	Up to 5 mood images (JPEG, PNG or WebP, 10 MB each). Only when the model writes the lyrics.
`reference_video_urls`Facoltativo	`array<string (uri)>`	—	fino a 1 elementi	One reference video (MP4 or WebM, up to 100 MB and 241 seconds). Only when the model writes the lyrics.
`reference_audio_urls`Facoltativo	`array<string (uri)>`	—	fino a 1 elementi	One reference audio clip (MP3 or WAV, 6 seconds to 30 minutes). Only when the model writes the lyrics.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "suno/v6-mini/text-to-audio",
  "input": {
    "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, hand claps and a catchy whistled hook"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"