Add vocals to uploaded music. Only works with uploaded audio, not Suno-generated clips.

​
Model

suno-ai/add-vocals

​
Parameters

ParameterTypeRequiredDescription
mvstringYesModel version
clip_idstringYesClip ID from uploaded audio
audio_urlstringNoAudio file URL
gpt_description_promptstringNoVocal description/lyrics
promptstringNoCustom mode prompt
start_snumberNoStart time in seconds
end_snumberNoEnd time in seconds
make_instrumentalbooleanNoGenerate instrumental
titlestringNoTitle for result

​
Example

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/add-vocals",
    "input": {
      "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
    }
  }'

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}

​
Pricing

$0.06 per operation