音乐生成 · 人声处理

基于音频 ID 提取指定片段的人声或伴奏处理结果。

基本信息

字段内容
应用编码music_generation
API 编码vox
请求方式POST
请求路径/api/v1/apps/music_generation/vox
调用模式异步

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

业务参数

参数类型必填默认值可选值 / 范围示例说明
audio_idstring是--audio_xxxxxxxxxxxx音频 ID,用于定位已生成或已上传的音频片段。
vocal_startnumber否---人声提取开始时间,单位秒。
vocal_endnumber否---人声提取结束时间,单位秒。
callback_urlstring否---任务完成或失败时由平台主动通知的 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
}

同类文章