Skip to main content
GET
/
suno
/
act
/
midi
/
{clip_id}
获取 midi
curl --request GET \
  --url https://api.deerapi.com/suno/act/midi/{clip_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "<string>",
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "action": "<string>",
    "status": "<string>",
    "fail_reason": "<string>",
    "submit_time": 123,
    "start_time": 123,
    "finish_time": 123,
    "progress": "<string>",
    "data": null
  }
}

获取 MIDI 文件

/suno/act/midi/\{clip_id\} 接口允许您检索音乐片段的 MIDI 文件。MIDI(乐器数字接口)文件包含音乐音符数据,可用于音乐制作、混音、学习或与数字音频工作站(DAW)集成。 此接口返回一个处理音频到 MIDI 转换的任务。完成后,您可以下载 MIDI 文件供进一步使用。
在使用此接口之前,您必须先使用生成音乐片段接口生成音乐,并通过单任务查询获取 clip_id

重要注意事项

  • 兼容性优势:与 Suno 官网仅支持全轨分离的 clip_id 不同,本接口同时支持全轨分离和普通音乐的 clip_id
  • 账户限制
    • MIDI 文件不可跨账户访问
    • 账户下线后此接口将不可调用
  • 异步处理:此接口返回 task_id。需要轮询单任务查询接口检查状态,并在就绪时检索 MIDI 文件 URL

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Path Parameters

clip_id
string
required

Response

200 - application/json

Successful Response

code
string

任务状态

message
string

提示信息,成功时通常为空,失败时可包含错误详情

data
object

业务数据主体,包含任务的具体信息