Add Vocals to Music

POST

/api/v1/generate/add-vocals

Generate music with vocals based on uploaded audio files. This interface allows you to upload audio files and add vocal singing to them.

Usage Guide

Use this interface to add vocal singing to existing audio

Supports custom lyric content and singing styles

Allows control of vocal gender, style weight, and other parameters

Parameter Details

uploadUrl specifies the audio file URL to be processed

prompt defines lyric content and singing style

style and negativeTags are used to control music and vocal 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

Body

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.kie.ai/api/v1/generate/add-vocals' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A calm and relaxing piano track.",
    "model": "V4_5PLUS",
    "title": "Relaxing Piano",
    "negativeTags": "heavy metal, strong drum beats",
    "style": "Jazz",
    "vocalGender": "m",
    "styleWeight": 0.61,
    "weirdnessConstraint": 0.72,
    "audioWeight": 0.65,
    "uploadUrl": "https://example.com/music.mp3",
    "callBackUrl": "https://example.com/callback"
}'

Response Example

200 - Example 1

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

Add Instrumental to Music

Get Music Task Details