人声归档

自动识别音频中的不同说话人，输出说话人时间段结构，并可将各说话人的音频片段归档为独立的音轨文件。

创建任务

基本信息

项目	值
请求方法	`POST`
请求路径	`/task/audio_speaker_split`
Content-Type	`application/json`
鉴权方式	`Authorization` 请求头（直接传 API Key）

请求参数（Body）

参数名	类型	必填	默认值	说明
`file_id`	`string`	是	—	已上传音频或视频文件的 ID
`only_struct`	`boolean`	否	`true`	`true`：仅返回说话人结构信息，不生成文件；`false`：同时生成各说话人独立音频文件
`keep_origin_length`	`boolean`	否	`false`	是否在输出文件中保持原始时长（用静音填充非该说话人的部分）

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/audio_speaker_split \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "only_struct": false,
    "keep_origin_length": false
  }'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "audio_speaker_split",
    "status": "queued"
  }
}

查询任务结果

基本信息

项目	值
请求方法	`GET`
请求路径	`/task/audio_speaker_split/{task_id}`
鉴权方式	`Authorization` 请求头（直接传 API Key）

响应参数（output_result）

参数名	类型	说明
`spoken_list`	`array`	说话人片段列表
`spoken_list[].speaker`	`string`	说话人标识，如 `"SPEAKER_01"`
`spoken_list[].start_time`	`number`	片段开始时间（秒）
`spoken_list[].end_time`	`number`	片段结束时间（秒）
`files`	`array`	分离后的音频文件列表（仅 `only_struct: false` 时返回）
`files[].speaker`	`string`	说话人标识
`files[].file_id`	`string`	该说话人的音频文件 ID
`files[].download_url`	`string`	音频下载路径

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "spoken_list": [
        {"speaker": "SPEAKER_01", "start_time": 0.0, "end_time": 5.2},
        {"speaker": "SPEAKER_02", "start_time": 5.5, "end_time": 12.8},
        {"speaker": "SPEAKER_01", "start_time": 13.0, "end_time": 18.6}
      ],
      "files": [
        {
          "speaker": "SPEAKER_01",
          "file_id": "537489015178248",
          "download_url": "/download/a1/speaker_01.wav"
        },
        {
          "speaker": "SPEAKER_02",
          "file_id": "537489015178249",
          "download_url": "/download/a1/speaker_02.wav"
        }
      ]
    },
    "create_time": "2026-04-05T08:00:00Z",
    "update_time": "2026-04-05T08:00:20Z"
  }
}

错误码

错误码	HTTP 状态码	说明	解决方案
`6013`	400	`file_id` 缺失	传入 `file_id` 参数
`6004`	404	文件不存在	检查 `file_id` 是否正确
`6502`	401	鉴权失败	检查 `Authorization` 请求头
`6202`	402	余额不足	前往仪表盘充值