Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Add vocals to uploaded music. See supported inputs, parameters, pricing, response fields, and API examples.
suno-ai/add-vocals
| Parameter | Type | Required | Description |
|---|---|---|---|
mv | string | Yes | Model version |
clip_id | string | Yes | Clip ID from uploaded audio |
audio_url | string | No | Audio file URL |
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 |
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 |
nsfw_check | boolean | No | Check uploaded media inputs for NSFW content. Default: true |
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
}
}'
{
"code": 200,
"success": true,
"data": {
"task_id": "abc123def456",
"status": "processing"
}
}