替换音乐分区
替换现有音乐的指定时间段。
使用指南
- 此接口可以替换已生成音乐中的特定时间段
- 需要提供原始音乐的任务ID和要替换的时间范围,或用户上传的音频URL和模型版本
- 替换后的音频会与原音乐自然融合
两种操作模式
模式 1:使用已有音频- 提供
taskId和audioId来替换已生成音乐中的指定分区
- 提供
uploadUrl和model来使用您自己上传的音频进行分区替换
参数详情
-
通用必需参数:
prompt:替换后的歌词tags:音乐风格标签title:音乐标题infillStartS:开始替换的时间点(秒,保留2位小数)infillEndS:结束替换的时间点(秒,保留2位小数)fullLyrics:修改后的完整歌词,包含修改和未修改歌词的合并
-
模式 1 必需参数:
taskId:原始音乐的父任务IDaudioId:要替换的音频ID(生成完成后的回调数据中返回)
-
模式 2 必需参数:
uploadUrl:用户上传的自定义音频URLmodel:AI模型版本(V4、V4_5、V4_5PLUS、V4_5ALL、V5、V5_5)
-
可选参数:
negativeTags:要排除的音乐风格callBackUrl:任务完成后的回调URL
时间范围说明
infillStartS必须小于infillEndS- 时间值精确到小数点后2位,例如:10.50秒
- 替换时间范围必须在 6 秒到 60 秒 之间
- 替换时长建议不超过原音乐总时长的50%
开发者注意事项
- 替换片段会根据提供的
prompt和tags重新生成 - 生成的替换片段会自动与原音乐前后部分融合
- 生成的文件将保留 14 天
- 查询任务状态使用与生成音乐相同的接口:获取音乐详情
授权
🔑 API 认证说明
所有接口都需要通过 Bearer Token 方式进行认证。
获取 API Key
- 访问 API Key 管理页面 获取您的 API Key
使用方式
在请求头中添加:
Authorization: Bearer YOUR_API_KEY⚠️ 注意:
- 请妥善保管您的 API Key,不要泄露给他人
- 如果怀疑 API Key 泄露,请立即在管理页面重置
请求体
- 使用已有音频进行分区替换
- 使用用户上传音频进行分区替换
原始任务ID(父任务),用于标识要进行分区替换的源音乐。
"2fac****9f72"
要替换的音频曲目的唯一标识符。此ID在音乐生成完成后的回调数据中返回。
"e231****-****-****-****-****8cadc7dc"
替换后的歌词
"A calm and relaxing piano track."
音乐的风格标签,如爵士、电子等
"Jazz"
音乐的标题
"Relaxing Piano"
开始替换的时间点(秒),保留2位小数。必须小于 infillEndS,且 infillEndS 与 infillStartS 的时间差必须在 6 秒到 60 秒之间。
x >= 010.5
结束替换的时间点(秒),保留2位小数。必须大于 infillStartS,且 infillEndS 与 infillStartS 的时间差必须在 6 秒到 60 秒之间。
x >= 020.75
修改后的完整歌词,包含修改和未修改歌词的合并。此参数包含在分区替换后整首歌曲将使用的完整歌词文本。
"[主歌1]\n原始歌词内容\n[副歌]\n此部分的修改歌词\n[主歌2]\n更多原始歌词"
排除的音乐风格,用于避免特定风格元素出现在替换片段中
"Rock"
生成任务完成后的回调URL。系统将在替换完成时向此URL发送POST请求,包含任务状态和结果。
"https://example.com/callback"
响应
请求成功
响应状态码
- 200: 成功 - 请求已成功处理
- 401: 未授权 - 身份验证凭据缺失或无效
- 402: 积分不足 - 账户没有足够的积分执行此操作
- 404: 未找到 - 请求的资源或端点不存在
- 409: 冲突 - WAV记录已存在
- 422: 验证错误 - 请求参数未通过验证检查
- 429: 超出限制 - 已超过对此资源的请求限制
- 451: 未授权 - 获取图像失败。请验证您或您的服务提供商设置的任何访问限制。
- 455: 服务不可用 - 系统当前正在进行维护
- 500: 服务器错误 - 处理请求时发生意外错误
200, 401, 402, 404, 409, 422, 429, 451, 455, 500 当 code != 200 时的错误信息
"success"
