替换音乐分区
POST
/api/v1/generate/replace-section
替换现有音乐的指定时间段。
使用指南
参数详情
必需参数
| 参数名 | 类型 | 说明 |
|---|---|---|
taskId | string | 原始音乐的父任务 ID |
audioId | string | 要替换的音频 ID |
prompt | string | 描述替换片段的提示词 |
tags | string | 音乐风格标签 |
title | string | 音乐标题 |
infillStartS | number | 开始替换的时间点（秒，保留 2 位小数） |
infillEndS | number | 结束替换的时间点（秒，保留 2 位小数） |
可选参数
| 参数名 | 类型 | 说明 |
|---|---|---|
negativeTags | string | 要排除的音乐风格 |
fullLyrics | string | 修改后的完整歌词，包含修改和未修改歌词的合并 |
callBackUrl | string | 任务完成后的回调地址 |
时间范围说明
infillStartS 必须小于 infillEndS开发者注意事项
Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/generate/replace-section' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"taskId": "2fac****9f72",
"audioId": "e231****-****-****-****-****8cadc7dc",
"prompt": "A calm and relaxing piano track.",
"tags": "Jazz",
"title": "Relaxing Piano",
"negativeTags": "Rock",
"infillStartS": 10.5,
"infillEndS": 20.75,
"fullLyrics": "[主歌1]\n原始歌词内容\n[副歌]\n此部分的修改歌词\n[主歌2]\n更多原始歌词",
"callBackUrl": "https://example.com/callback"
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}