Add Vocals - Unifically

Add vocals to uploaded music. Only works with uploaded audio, not Suno-generated clips. Try it in the browser: Suno Add Vocals API playground.

Model

suno-ai/add-vocals

Parameters

Parameter	Type	Required	Description
`mv`	string	Yes	Model version
`clip_id`	string	Yes*	Clip ID from uploaded audio
`audio_url`	string	Yes*	Audio file URL. It is uploaded to Suno first and used in place of `clip_id`
`gpt_description_prompt`	string	No	Vocal description/lyrics
`prompt`	string	No	Custom mode prompt
`start_s`	number	No	Start time in seconds
`end_s`	number	No	End time in seconds
`make_instrumental`	boolean	No	Generate instrumental
`tags`	string	No	Genre/style tags
`negative_tags`	string	No	Styles to avoid
`title`	string	No	Title for result
`custom_model`	object	No	Required when `mv` is `chirp-custom`. Inline custom model — `{ "name": string, "audio_urls": string[] }`. See Music Generation › Custom Model

* Provide either clip_id or audio_url, not both.

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-hawk",
      "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": "processing"
  }
}

Volume discounts are available for almost all models. Reach out at contact@unifically.com to discuss custom pricing.