Introduction
Suno describes it as a faster, more efficient version of v6 that makes it easier to turn an idea into a song. You send a style brief in prompt, optionally your own lyrics, and get two MP3s back.
Key features
Idea in, song out
Write a sentence and leave lyrics empty: with generate_lyrics on (the default) the model writes the words and sings them. In our test it wrote about three and a half minutes of lyrics and sang every line in order.
The same lyric handling
Bring your own words and v6 Mini sings them as written. The 11-line lyric sheet we used on all three models came back word for word and in order, with [Verse] and [Chorus] tags kept silent.
A pair of takes
Every request returns two versions, which can differ in length.
Request parameters
| Parameter | Required | Description |
|---|---|---|
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. Default: true |
image_urls | No | Pictures that set the mood; the music takes its feel from them. |
instrumental | No | Music only, no vocals. Default: false |
lyrics | No | Write your own lyrics, or leave it to the model. |
negative_prompt | No | Styles or sounds you don't want in the track. |
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 | Yes | 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 to match: a voice, music or a rhythm. |
reference_video_urls | No | A video the music should fit. |
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 |
Pricing
Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.
| Option | Credits per run | ≈ USD |
|---|---|---|
| Standard | 10.8 | $0.11 |
Each task is rounded up to whole credits, so one run at the lowest tier costs 11 credits per run ($0.11).
For an exact number before you run, send the same body to POST /jobs/quote.
Use cases
Sketching songs fast
Use it as a notebook: type the hook, hear it, rewrite it. Short lyric sheets give songs of about a minute and a half.
Gentle, acoustic and lounge styles
Folk, indie and jazz briefs with a handful of named instruments are what we generated for our samples, from a fingerpicked folk song to a smoky lounge instrumental.
Prompt guide & pro tips
Keep the brief short and concrete
Name the genre, tempo in bpm and two or three instruments, for example “acoustic indie folk, 96 bpm, warm male vocal, fingerpicked guitar”.
Let it write, then take over
Start with an idea and read the lyrics the model chose. Copy the ones you like into lyrics, edit them and run again to get them sung exactly as you wrote them.
API quick start
Call the Suno v6 Mini API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
- Send the request. POST /jobs/createTask with model suno/v6-mini/text-to-audio and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 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"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
Suno v6 Mini API questions
How much does the Suno v6 Mini API cost?
Suno v6 Mini costs 11 credits ($0.11) per run. Credits are the same as on the website (1 credit = $0.01), new accounts get 30 free credits, and failed tasks are refunded.
What is the model name for Suno v6 Mini in the API?
Put suno/v6-mini/text-to-audio for Music in the model field of POST /jobs/createTask.
What is v6 Mini?
Suno describes v6 Mini as a faster, more efficient version of v6 that makes it easier to turn an idea into a song, and says it is the version available to everyone. It launched on 9 September 2026 with v6 and v6 Wild.
Is the lyrics handling the same as v6?
In our tests, yes: all three sang the same clean 11-line lyric sheet word for word, in order, with section tags kept silent. We did not rank their sound.
Am I charged if a request is rejected or fails?
No. The amount held for the request is released in full.
Can I choose who sings?
Partly. Describe the voice in the style brief, such as a warm male vocal. With your own lyrics or instrumental on you can also set vocal_gender to female or male; it is a preference, not a guarantee, and we have not measured how often it holds. A duet asked for in one sentence came back as a solo in our test.
What are the limits of the Suno v6 Mini API?
Reference images: 5; Reference audio: 1; Reference videos: 1; Prompt length (characters): 3,000. Requests outside these limits are rejected before anything is charged.
Can I try Suno v6 Mini without writing code?
Yes. The Playground runs Suno v6 Mini on your PopNow credits, needs no API key, and shows the matching code for every run.
All Suno models
Suno v6 is the more precise model for finished songs, at the same price per run.
