POST
/
suno
/
add-instrumental
Add Instrumental
curl --request POST \
  --url https://api.unifically.com/suno/add-instrumental \
  --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 instrumental backing to uploaded music. Note: Only works with uploaded audio, not Suno-generated clips.

​
Pricing

For current pricing, see the Pricing page.

​
Simple Mode Example

curl -X POST "https://api.unifically.com/suno/add-instrumental" \
  -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": "Hip-hop beats with 808 bass",
    "start_s": 0,
    "end_s": 60
  }'

​
Custom Mode Example

curl -X POST "https://api.unifically.com/suno/add-instrumental" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "mv": "chirp-bluejay",
    "clip_id": "ec0be483-2de2-4abc-a5ce-3d8258f52ed4",
    "audio_url": "https://example.com/audio.mp3",
    "prompt": "Rock guitar and drums",
    "title": "With Instrumental",
    "start_s": 0,
    "end_s": 60,
    "advanced_settings": {
      "style_weight": 0.7,
      "audio_weight": 0.8
    }
  }'

​
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
Description for custom mode
​
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 instrumental overlay
​
end_s
number
End time in seconds for instrumental overlay
​
advanced_settings
object
Advanced controls (see Overview)

​
Response

Response format is the same as Music Generation.