添加人声生成音乐

POST

/api/v1/generate/add-vocals

基于上传的音频文件生成带人声的音乐。此接口允许您上传音频文件并为其添加人声演唱。

使用指南

使用此接口为现有音频添加人声演唱

支持自定义歌词内容和演唱风格

可以控制人声性别、风格权重等参数

参数详情

uploadUrl 指定要处理的音频文件URL

prompt 定义歌词内容和演唱方式

model 用于指定生成的AI模型版本

style 和 negativeTags 用于控制音乐和人声风格

支持多种可选参数来精细调节生成效果

开发者注意事项

生成的文件将保留14天

回调过程分三个阶段：text（文本生成）、first（第一首完成）、complete（全部完成）

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

请求成功

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": "重金属, 强节奏鼓点",
    "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"
    }
}

添加伴奏生成音乐

获取音乐任务详情