钢琴音频转 MIDI

将上传的钢琴音频转换为 MIDI 文件，适用于旋律提取、编曲复现、乐谱制作、音乐教育和素材再创作等场景。

• 接口路径：POST /task/piano_audio_to_midi
• 任务类型：piano_audio_to_midi
• 计费方式：按音频时长计费（分钟）
• 输出格式：MIDI

请求参数

参数	类型	必填	默认值	说明
file_id	string	是	-	上传文件返回的文件 ID，详见 文件上传

请求示例

curl -X POST "https://cloud.ai-mcn.tv/task/piano_audio_to_midi" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246"
  }'

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "537489015178247"
  }
}

任务创建后为异步处理，可通过任务查询接口轮询状态，也可以使用 任务进度查询订阅进度。

结果获取

任务完成后，请求 GET /task/piano_audio_to_midi/{task_id} 获取结果：

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "download_url": "/download/a1/537489015178248.mid"
    }
  }
}

字段说明

字段	类型	说明
output_result.file_id	string	生成的 MIDI 文件 ID
output_result.download_url	string	MIDI 文件下载地址

使用限制

• 输入仅支持音频文件（mp3、wav、m4a、aac、flac、ogg 等）。
• 更适合钢琴独奏或钢琴主导的音频；复杂混音可能降低转写准确率。
• 按音频时长计费，任务失败会按后端计费规则自动回滚。

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_id 缺失	传入 file_id 参数
6014	400	文件类型不支持	上传受支持的音频文件
6017	400	媒体探测失败	确认文件未损坏且为有效音频
6004	404	文件不存在	检查 file_id 是否正确
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值