POST
https://api.unifically.com
/
suno
/
add-vocals
Add Vocals
curl --request POST \
  --url https://api.unifically.com/suno/add-vocals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mv": "<string>",
  "clip_id": "<string>",
  "audio_url": "<string>",
  "prompt": "<string>",
  "gpt_description_prompt": "<string>",
  "make_instrumental": true,
  "title": "<string>",
  "start_s": 123,
  "end_s": 123,
  "advanced_settings": {}
}
'
Add vocals to uploaded music. Note: Only works with uploaded audio, not Suno-generated clips.

​
Pricing

For current pricing, see the Pricing page.

​
Request Example

curl -X POST "https://api.unifically.com/suno/add-vocals" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "mv": "chirp-bluejay",
    "clip_id": "ec0be483-2de2-4abc-a5ce-3d8258f52ed4",
    "gpt_description_prompt": "[Verse 1]\nNew vocal lyrics here",
    "start_s": 10,
    "end_s": 60
  }'

​
Parameters

​
mv
string
required
Model version (see Available Models)
​
clip_id
string
required
ID of audio clip (from uploaded audio)
​
audio_url
string
Publicly accessible audio file URL. Supports MP3, WAV formats.Example: "https://example.com/audio.mp3"
​
prompt
string
Vocal prompt/lyrics
​
gpt_description_prompt
string
Description prompt for simple mode
​
make_instrumental
boolean
Generate instrumental version
​
title
string
Title for the result
​
start_s
number
Start time in seconds for vocal overlay
​
end_s
number
End time in seconds for vocal overlay
​
advanced_settings
object
Advanced controls (see Overview)

​
Response

Response format is the same as Music Generation.