Suno v6 Wild API reference

Call Suno v6 Wild from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in credits, and a request you can paste into a terminal.

At a glance

Made by: Suno
Output: Audio
From: 10.8 credits per request ($0.108)
Model IDs: suno/v6-wild/text-to-audio

1 credit = $0.01. A task holds the highest possible charge when it is accepted and settles the real amount when it finishes, rounded up to whole credits; failed tasks are not charged. Ask POST /api/v1/jobs/quote for the exact figure before you run.

Music

suno/v6-wild/text-to-audio

Price

Option	Credits (per request)	US dollars
`Default`	10.8	$0.108

Parameters

Field	Type	Default	Allowed	What it does
`prompt`Required	`string`	—	up to 3,000 characters	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`Optional	`string`	—	up to 5,000 characters	Words to sing, sung in order. Section tags such as [Verse], [Chorus] and [Bridge] shape the song and are not sung.
`generate_lyrics`Optional	`boolean`	`true`	—	Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off.
`instrumental`Optional	`boolean`	`false`	—	Generate music with no vocals.
`title`Optional	`string`	—	up to 80 characters	Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song.
`negative_prompt`Optional	`string`	—	up to 500 characters	Styles or elements to keep out of the song.
`vocal_gender`Optional	`string`	—	female, male	Make a female or male lead vocal more likely. Applies with lyrics.
`style_weight`Optional	`number`	—	0 to 1	How closely to follow the style in the prompt, from 0 to 1.
`weirdness`Optional	`number`	—	0 to 1	How experimental the song may get, from 0 (conventional) to 1 (unusual).
`audio_weight`Optional	`number`	—	0 to 1	How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only.
`variety`Optional	`integer`	—	0 to 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`Optional	`string`	—	up to 200 characters	ID of an existing Suno persona to reuse its style or voice.
`persona_model`Optional	`string`	—	style_persona, voice_persona	Whether persona_id is a style persona or a voice persona.
`image_urls`Optional	`array<string (uri)>`	—	up to 5 items	Up to 5 mood images (JPEG, PNG or WebP, 10 MB each). Only when the model writes the lyrics.
`reference_video_urls`Optional	`array<string (uri)>`	—	up to 1 items	One reference video (MP4 or WebM, up to 100 MB and 241 seconds). Only when the model writes the lyrics.
`reference_audio_urls`Optional	`array<string (uri)>`	—	up to 1 items	One reference audio clip (MP3 or WAV, 6 seconds to 30 minutes). Only when the model writes the lyrics.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

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-wild/text-to-audio",
  "input": {
    "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, hand claps and a catchy whistled hook"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

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"