获取音乐的MIDI数据

GET

https://api.gptgod.online/suno/act/midi/{clip_id}

最后修改时间：2025-11-12 14:51:25

x-codeSamples：[{"lang":"Python","label":"轮询直到完成","source":"import requests\nimport time\n\nclip_id = \"c5bffd3a-96ad-4e83-9fbe-4720a5b9a664\"\nurl = f\"/suno/act/midi/{clip_id}\"\nheaders = {\"Authorization\": \"Bearer YOUR_API_KEY\"}\n\nwhile True:\n response = requests.get(url, headers=headers)\n data = response.json()\n \n if data[\"state\"] == \"complete\":\n print(\"MIDI数据:\", data[\"instruments\"])\n break\n elif data[\"state\"] == \"running\":\n print(\"处理中，等待5秒...\")\n time.sleep(5)\n else:\n print(\"错误:\", data)\n break\n"}]

接口说明

获取音乐的MIDI数据，包含所有音符信息

使用方法

先使用场景8进行全轨分离，获得 clip_id

使用该 clip_id 调用此接口

如果返回 state: "running"，需要轮询等待

当返回 state: "complete" 时，获得完整MIDI数据

注意事项

建议使用全轨分离后的 clip_id

普通音乐的 clip_id 也能执行，但可能没有数据

仅支持同账号下的 clip_id

账号下线后不可调用

返回内容

乐器列表 (instruments)

每个音符的 pitch, start, end, velocity

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.gptgod.online/suno/act/midi/c5bffd3a-96ad-4e83-9fbe-4720a5b9a664' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200成功

application/json

成功获取MIDI数据或处理状态

Body

示例

处理中（需要轮询）处理完成

{
    "state": "running"
}

🟠400请求有误

🟠401未认证

🟠404未找到

修改于 2025-11-12 14:51:25

上传自定义音频文件

扩展Style Tags（风格标签）

获取音乐的MIDI数据

接口说明#

使用方法#

注意事项#