音频变调变速

调整音频的音高（变调）与播放速度（变速），二者相互独立：改变速度不影响音高，改变音高不影响时长。基于高质量算法处理，变调时自动保留音色，不会出现"花栗鼠"般的失真。

创建任务

基本信息

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

请求参数（Body）

参数名	类型	必填	默认值	说明
`file_id`	`string`	是	—	已上传音频文件的 ID
`semitones`	`number`	否	`0`	变调半音数。正数升调、负数降调、`0` 不变调。建议范围 `-12` ~ `+12`
`speed`	`number`	否	`1.0`	变速倍率。大于 1 变快、小于 1 变慢、等于 1 不变速。必须大于 0，建议范围 `0.5` ~ `2.0`

变调与变速可同时设置，互不影响。例如 semitones=2 且 speed=1.5 表示在升高两个半音的同时以 1.5 倍速播放。

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/audio_stretch \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "semitones": 2,
    "speed": 1.5
  }'

成功响应示例

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

查询任务结果

基本信息

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

响应参数（output_result）

参数名	类型	说明
`file_id`	`string`	处理后的音频文件 ID
`download_url`	`string`	音频下载路径

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "download_url": "/download/a1/537489015178248.wav"
    },
    "create_time": "2026-05-30T08:00:00Z",
    "update_time": "2026-05-30T08:00:20Z"
  }
}

使用限制

输入仅支持音频文件（mp3、wav、m4a、aac、flac、ogg 等）。
按音频时长（分钟）计费。
输出格式为 wav。
speed 必须大于 0；semitones 与 speed 取值越极端，音质损失越明显，建议在推荐范围内使用。

错误码

错误码	HTTP 状态码	说明	解决方案
`6013`	400	`file_id` 缺失	传入 `file_id` 参数
`6014`	400	文件类型不支持，或 `semitones`/`speed` 类型不正确	上传受支持的音频文件，确保参数为数值
`6016`	400	业务参数非法（如 `speed` ≤ 0）	使 `speed` 大于 0
`6017`	400	媒体探测失败	确认文件未损坏且为有效音频
`6004`	404	文件不存在	检查 `file_id` 是否正确
`6502`	401	鉴权失败	检查 `Authorization` 请求头
`6202`	402	余额不足	前往仪表盘充值