curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "add-instrumental",
"callback_url": "https://your-domain.com/callback",
"input": {
"upload_url": "https://cdn.vidgo.ai/temp/vocals.mp3",
"title": "Relaxing Piano",
"tags": "relaxing, piano, soothing",
"negative_tags": "heavy metal, fast drums"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2025-11-12T10:30:00"
}
}Suno AI
Add Instrumental
Generate musical accompaniment for uploaded audio files
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "add-instrumental",
"callback_url": "https://your-domain.com/callback",
"input": {
"upload_url": "https://cdn.vidgo.ai/temp/vocals.mp3",
"title": "Relaxing Piano",
"tags": "relaxing, piano, soothing",
"negative_tags": "heavy metal, fast drums"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2025-11-12T10:30:00"
}
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the response result through the unified Query Music Detail endpoint.
Usage Guide
- This endpoint generates musical accompaniment for uploaded audio files
- Typically used with vocal stems or melodies to create backing tracks
- Perfect for adding instrumental layers to existing recordings without needing a producer
Parameter Details
-
Required parameters:
-
upload_url: URL of the audio file to process -
title: Name for the generated track -
tags: Desired musical styles (e.g., “relaxing, piano, soothing”) -
negative_tags: Styles to exclude (e.g., “heavy metal, fast drums”)
-
-
Model selection:
- V5: Superior musical expressiveness with faster generation
- V4_5PLUS: Enhanced tonal richness (default)
Usage Notes
- Use descriptive tags to guide the style of the instrumental
- Combine positive and negative tags for precise control over the output
- The callback mechanism sends notifications at three stages: text generation, first track completion, and all tracks completed
Optional parameters
-
model(string): AI model version. Options:V4_5PLUS(default),V5. -
vocal_gender(string): Vocal gender preference. Usemfor male,ffor female. Note: This parameter can only increase the probability but cannot guarantee the specified gender. -
style_weight(number): Strength of adherence to style. Range 0-1, up to 2 decimals. -
weirdness_constraint(number): Controls creative deviation. Range 0-1, up to 2 decimals. -
audio_weight(number): Balance weight for audio features. Range 0-1, up to 2 decimals.
Authorizations
All API endpoints require Bearer Token authentication
Get your API Key:
Visit the API Key Management Page to get your API Key
Add it to the request header:
Authorization: Bearer VIDGO_API_KEY
Body
application/json