Introduction
The Suno v6 API suits an arrangement you can describe precisely: our dance-pop theme follows its supplied words, while the orchestral sample removes vocals entirely; two takes share one request price. For a finished v6 brief, separate the words in lyrics from the musical direction in prompt; with no words supplied, keep generate_lyrics on or choose instrumental. Assemble the v6 brief with compatible controls: title, persona and style settings accompany custom lyrics or instrumental, while reference media accompany generated lyrics; invalid combinations are rejected.
| Field | Value |
|---|---|
| Input | Text |
| Output | Audio |
| Required field | Specify the v6 arrangement through tempo, instruments and vocal character: a 1,000-character style brief with lyrics or instrumental, otherwise a 3,000-character song idea. Included in the v6 request price. |
| Optional fields | Assemble the v6 brief with compatible controls: title, persona and style settings accompany custom lyrics or instrumental, while reference media accompany generated lyrics; invalid combinations are rejected. |
| Result | A v6 commission returns two full MP3 performances of the brief; comparing the arrangements does not incur a second song charge. |
| Lyrics | For a finished v6 brief, separate the words in lyrics from the musical direction in prompt; with no words supplied, keep |
| Billed quantity | A v6 commission returns two full MP3 performances of the brief; comparing the arrangements does not incur a second song charge. |
| Retention | Download the selected v6 performance before its 14-day retention ends, and clear the submitted lyrics and publication rights for your intended release. |
Key features & highlights
Our theme song, every line in order
This is the SpicyAPI theme song, written by us and sung by v6 as a bright dance-pop anthem. All 10 lines came back in the order written and the section tags stayed silent; writing the brand as “A-P-I” in the lyrics got it sung letter by letter.
One sentence in, a whole song out
Send a description with no lyrics and Suno writes the words before it sings them. This seaside road-trip love song came from a single sentence: the title, “Every Coast Road”, the verses and the hook are all the model’s own.
Instrumentals with nothing sung
Turn instrumental on and the track has no vocal at all. “Golden Hour Overture” is sweeping strings, soft piano and warm brass swells from a one-line brief and a title; in our runs, instrumental tracks came back without a single word.
Request parameters
| Parameter | Required | Description |
|---|---|---|
prompt | Yes | Specify the v6 arrangement through tempo, instruments and vocal character: a 1,000-character style brief with lyrics or instrumental, otherwise a 3,000-character song idea. at least 1 characters · at most 3000 characters |
lyrics | No | Put the final v6 lyric sheet here, within 5,000 characters; our test preserved line order and left standalone section tags unvoiced. Included in the v6 request price. at least 1 characters · at most 5000 characters |
generate_lyrics | No | Keep the default true for v6 to compose lyrics from the brief; supplied lyrics are preserved, and instrumental disables lyric writing. Included in the v6 request price. Default: |
instrumental | No | Set true to commission an instrumental v6 arrangement, using a style-only prompt of up to 1,000 characters; vocals are enabled by default. Included in the v6 request price. Default: |
title | No | Set the v6 song’s metadata title, at most 80 characters, for custom lyrics or instrumental; automatic lyrics come with an automatic title. at least 1 characters · at most 80 characters |
negative_prompt | No | Define what the v6 arrangement should avoid, using an optional list within 500 characters rather than adding those exclusions to the lyrics. Included in the v6 request price. at least 1 characters · at most 500 characters |
vocal_gender | No | Request a female or male v6 lead vocal; our tests do not establish how reliably that preference is honored. |
style_weight | No | Adjust v6’s adherence to the requested arrangement using 0–1, with a step size of 0.01. Use v6 fine controls only with supplied lyrics or an instrumental request. |
weirdness | No | Choose how conventional or adventurous the v6 arrangement may be, from 0 to 1 in increments of 0.01. Use v6 fine controls only with supplied lyrics or an instrumental request. |
audio_weight | No | Controls persona-audio influence on the v6 vocal performance, with values 0–1 in 0.01 increments; unavailable for instrumentals. |
variety | No | Control v6 style-prompt variation with integers 0–4, initially 1; Suno says 0 retains the original tags, a behavior we have not separately tested. |
persona_id | No | Identify the saved Suno persona for the v6 performance and supply |
persona_model | No | Select the kind of v6 persona reuse: |
image_urls | No | Attach at most 5 JPEG, PNG or WebP images to guide the v6 song concept; the per-image limit is 10 MB. at most 5 items |
reference_video_urls | No | Guide the v6 song concept with one video reference, MP4 or WebM, capped at 100 MB and 241 seconds. at most 1 items |
reference_audio_urls | No | Provide one cleared audio reference for v6, in MP3 or WAV: 6 seconds–30 minutes, maximum 500 MB. at most 1 items |
Pricing
$0.072 / request
A v6 commission returns two full MP3 performances of the brief; comparing the arrangements does not incur a second song charge.
Use cases
Finished songs from your own lyrics
Paste a lyric sheet with [Verse] and [Chorus] tags, describe the sound, and get it back sung as written. Suno says v6 is its reliable, precise model, which suits a song you already have in mind.
Demos that sound like a record
Hear a lyric with a real arrangement before you take it to a studio. Two versions per request give you an A and a B to compare.
Theme songs and gifts
Birthday songs, wedding toasts, a channel anthem or a character theme: write the lines that matter and choose the voice and the mood.
Scores built around a video
Hand the model a reference video and let it write a song to match, or switch on instrumental for a clean underscore.
Prompt guide & pro tips
Describe the style
Give v6 a precise arrangement brief, such as the dance-pop sample’s synth bass and 118 bpm tempo; keep section tags apart from the lines to sing.
Add your lyrics
Put the final v6 lyric sheet here, within 5,000 characters; our test preserved line order and left standalone section tags unvoiced. Included in the v6 request price.
Or let it write
For a finished v6 brief, separate the words in lyrics from the musical direction in prompt; with no words supplied, keep
generate_lyricson or choose instrumental.
Song ideas in practice
The Suno v6 API suits an arrangement you can describe precisely: our dance-pop theme follows its supplied words, while the orchestral sample removes vocals entirely; two takes share one request price. For a finished v6 brief, separate the words in lyrics from the musical direction in prompt; with no words supplied, keep generate_lyrics on or choose instrumental. Assemble the v6 brief with compatible controls: title, persona and style settings accompany custom lyrics or instrumental, while reference media accompany generated lyrics; invalid combinations are rejected.
Listen to this model
Our theme song, every line in order
This is the SpicyAPI theme song, written by us and sung by v6 as a bright dance-pop anthem. All 10 lines came back in the order written and the section tags stayed silent; writing the brand as “A-P-I” in the lyrics got it sung letter by letter.
One sentence in, a whole song out
Send a description with no lyrics and Suno writes the words before it sings them. This seaside road-trip love song came from a single sentence: the title, “Every Coast Road”, the verses and the hook are all the model’s own.
Instrumentals with nothing sung
Turn instrumental on and the track has no vocal at all. “Golden Hour Overture” is sweeping strings, soft piano and warm brass swells from a one-line brief and a title; in our runs, instrumental tracks came back without a single word.
Choose what it should invent
For a finished v6 brief, separate the words in lyrics from the musical direction in prompt; with no words supplied, keep generate_lyrics on or choose instrumental.
Give v6 a precise arrangement brief, such as the dance-pop sample’s synth bass and 118 bpm tempo; keep section tags apart from the lines to sing.
Keep the settings compatible
Assemble the v6 brief with compatible controls: title, persona and style settings accompany custom lyrics or instrumental, while reference media accompany generated lyrics; invalid combinations are rejected.
Control v6 style-prompt variation with integers 0–4, initially 1; Suno says 0 retains the original tags, a behavior we have not separately tested. Use v6 fine controls only with supplied lyrics or an instrumental request. Included in the v6 request price.
Compare and save the takes
A v6 commission returns two full MP3 performances of the brief; comparing the arrangements does not incur a second song charge.
This v6 endpoint cannot target an exact runtime; the 0:55 theme and 2:48 orchestral sample show why a production cue needs checking after generation.
Download the selected v6 performance before its 14-day retention ends, and clear the submitted lyrics and publication rights for your intended release.
Content review
Suno’s own moderation also applies to the polished v6 model: stronger NSFW requests were refused without charge in SpicyAPI tests, and this integration does not disable that review. SpicyAPI adds no separate moderation layer to v6. The unrestricted ElevenLabs Music v2.5 family is another music option.
Artist-name requests were rejected in the v6 tests; communicate the arrangement through tempo, instrumentation and vocal character instead.
Suno’s own moderation also applies to the polished v6 model: stronger NSFW requests were refused without charge in SpicyAPI tests, and this integration does not disable that review. SpicyAPI adds no separate moderation layer to v6. The unrestricted ElevenLabs Music v2.5 family is another music option.
API quick start
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
See the API reference for authentication, the complete schema, polling, and error handling.


