静音片段移除

自动检测并移除音频中过长的静音片段，在非静音片段之间保留指定长度的静音，使音频更紧凑流畅。

创建任务

基本信息

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

请求参数（Body）

参数名	类型	必填	默认值	说明
file_id	string	是	—	已上传音频文件的 ID
min_silence_len	integer	否	1500	多长的静音算作停顿（毫秒），取值 100–60000；达到这个时长的静音才会被处理
desired_silence_len	integer	否	1500	非静音片段之间插入的静音长度（毫秒），取值 0–60000；0 表示不再插入静音

每段有声片段的两端还会各保留约 0.1 秒原有静音，避免声音被生硬截断。所以处理后的实际停顿约比 desired_silence_len 多 0.2 秒；设为 0 时，片段之间约剩 0.2 秒。

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/audio_silence_remove \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "min_silence_len": 1500,
    "desired_silence_len": 500
  }'

成功响应示例

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

---

查询任务结果

基本信息

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

响应参数（output_result）

参数名	类型	说明
file_id	string	处理后的音频文件 ID
download_url	string	音频下载路径
original_duration	number	原始音频时长（秒）
processed_duration	number	处理后时长（秒）
removed_silence_count	number	被删除或缩短的停顿数量（含片头、片尾的静音）

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "download_url": "/download/a1/output_trimmed.mp3",
      "original_duration": 180.5,
      "processed_duration": 120.3,
      "removed_silence_count": 15
    },
    "create_time": "2026-04-05T08:00:00Z",
    "update_time": "2026-04-05T08:00:08Z"
  }
}

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_id 缺失	传入 file_id 参数
6016	400	min_silence_len 或 desired_silence_len 超出取值范围、不是整数	按请求参数表的取值范围传整数
6004	404	文件不存在	检查 file_id 是否正确
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值

任务失败

任务失败时 status 为 failed，output_result.error 说明原因，扣除的积分会自动退回。

情况	output_result.error	解决方案
整段音频都低于静音阈值，切不出有声片段	整段音频都是静音，没有可保留的声音，请更换音频后重试	更换含有声音的音频