获取 midi

GET

/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 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/suno/act/midi/8ba65c14-73d9-4547-bae0-44e97d77c5ff' \
--header 'Authorization: Bearer {{api-key}}'

响应示例

{
  "code": "0",
  "message": "操作成功",
  "data": {
    "task_id": "1a2b3c4d-5e6f-7890-abcd-ef0123456789",
    "action": "image_generation",
    "status": "FINISHED",
    "fail_reason": null,
    "submit_time": 1732320000,
    "start_time": 1732320005,
    "finish_time": 1732320025,
    "progress": "100%",
    "data": null
  }
}

批量查询任务

创建视频

获取 midi

获取 MIDI 文件#

重要注意事项#

请求参数

返回响应

获取 MIDI 文件

重要注意事项