Add Instrumental to Music

POST

/api/v1/generate/add-instrumental

Generate instrumental accompaniment based on uploaded audio files. This interface allows you to upload audio files and add instrumental tracks to them.

Usage Guide

Use this interface to add instrumental tracks to existing audio

Supports generation of various music style accompaniments

Allows customization of style, exclusion of specific elements, etc.

Parameter Details

uploadUrl specifies the audio file URL to be processed

title specifies the title for the generated music

tags and negativeTags are used to control music style

Supports various optional parameters for fine-tuning generation effects

Developer Notes

Generated files will be retained for 14 days

Callback process has three stages: text (text generation), first (first track completed), complete (all completed)

Callbacks

audioGenerated

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Request successful

Bodyapplication/json

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kie.ai/api/v1/generate/add-instrumental' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "uploadUrl": "https://example.com/music.mp3",
  "title": "Relaxing Piano",
  "negativeTags": "heavy metal, fast drums",
  "tags": "relaxing, piano, soothing",
  "callBackUrl": "https://example.com/callback",
  "model": "V4_5PLUS",
  "vocalGender": "m",
  "styleWeight": 0.61,
  "weirdnessConstraint": 0.72,
  "audioWeight": 0.65
}'

Response Example

200 - Example 1

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "5c79****be8e"
    }
}

Upload And Extend Audio

Add Vocals to Music