获取 midi

GET

https://api.deerapi.com/suno/act/midi/{clip_id}

获取 MIDI 文件

/suno/act/midi/{clip_id} 接口允许您检索音乐片段的 MIDI 文件。MIDI（乐器数字接口）文件包含音乐音符数据，可用于音乐制作、混音、学习或与数字音频工作站（DAW）集成。

此接口返回一个处理音频到 MIDI 转换的任务。完成后，您可以下载 MIDI 文件供进一步使用。

在使用此接口之前，您必须先使用生成音乐片段接口生成音乐，并通过单任务查询获取 clip_id。

重要注意事项

兼容性优势：与 Suno 官网仅支持全轨分离的 clip_id 不同，本接口同时支持全轨分离和普通音乐的 clip_id

账户限制：

MIDI 文件不可跨账户访问

账户下线后此接口将不可调用

异步处理：此接口返回 task_id。需要轮询单任务查询接口检查状态，并在就绪时检索 MIDI 文件 URL

请求参数

Path 参数

Header 参数

返回响应

🟢200Successful Response

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.deerapi.com/suno/act/midi/8ba65c14-73d9-4547-bae0-44e97d77c5ff' \
--header 'Authorization: Bearer '

响应示例

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "dcb812bd-40c5-4907-836e-3a7aa9a2e546",
    "action": "MUSIC",
    "status": "NOT_START",
    "fail_reason": "",
    "submit_time": 1747203819,
    "start_time": 1747203819,
    "finish_time": 0,
    "progress": "0%",
    "data": null
  }
}

修改于 2025-11-24 10:21:11

批量查询任务

创建视频

获取 midi

获取 MIDI 文件#

重要注意事项#

请求参数

返回响应

获取 MIDI 文件

重要注意事项