音乐生成 · 人声处理
基于音频 ID 提取指定片段的人声或伴奏处理结果。
基本信息
| 字段 | 内容 |
|---|---|
| 应用编码 | music_generation |
| API 编码 | vox |
| 请求方式 | POST |
| 请求路径 | /api/v1/apps/music_generation/vox |
| 调用模式 | 异步 |
鉴权
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
业务参数
| 参数 | 类型 | 必填 | 默认值 | 可选值 / 范围 | 示例 | 说明 |
|---|---|---|---|---|---|---|
audio_id | string | 是 | - | - | audio_xxxxxxxxxxxx | 音频 ID,用于定位已生成或已上传的音频片段。 |
vocal_start | number | 否 | - | - | - | 人声提取开始时间,单位秒。 |
vocal_end | number | 否 | - | - | - | 人声提取结束时间,单位秒。 |
callback_url | string | 否 | - | - | - | 任务完成或失败时由平台主动通知的 HTTPS 地址。 |
响应说明
提交成功后返回平台 task_id。请使用本应用查询接口或统一任务查询接口获取最终结果;如果请求传入 callback_url,平台会在任务终态时主动通知。
提交成功示例
{
"code": 1,
"msg": "success",
"data": {
"task_id": "task_xxxxxxxxxxxx",
"status": "processing",
"app": "music_generation",
"api": "vox",
"frozen_points": 14,
"actual_points": 0,
"created_at": "2026-07-06T14:32:35Z"
}
}
查询完成示例
{
"code": 1,
"msg": "success",
"data": {
"result": {
"task_id": "task_xxxxxxxxxxxx",
"status": "completed",
"data": {
"id": "vox_xxxxxxxxxxxx",
"status": "complete",
"vocal_start_s": "0.0",
"vocal_end_s": "20.0"
}
},
"usage": {
"points_cost": 14,
"actual_points": 14
}
}
}
失败示例
{
"code": 0,
"msg": "任务处理失败,请稍后重试",
"data": null
}