查询任务
按任务 ID 查询 Suno MJ 任务状态与结果。不同任务类型返回不同的结果字段。
使用提交接口返回的任务 ID 查询任务状态和结果。
GET
/suno/mj/fetch/{job_id}Authorization
bearerAuth AuthorizationBearer <token>
使用 Authorization: Bearer your-api-key 认证。
In: header
Path Parameters
job_id*string
提交接口返回的任务 ID；按对应响应读取 jobId 或 job_id，不是音轨 ID。
Response Body
application/json
application/json
application/json
任务 ID 与音轨 ID
| 标识 | 用途 |
|---|---|
jobId / job_id | 任务 ID，用于查询状态和结果；按对应提交接口的实际响应读取。 |
music_id / musicId | 音轨 ID，用于翻唱、续写、添加人声或添加伴奏。 |
上传参考音频支持同步与异步两种方式。同步成功直接返回音轨 ID；异步上传完成后，音轨 ID 位于查询响应的 data.data.data.musics[].musicId。不要把音轨 ID 当作任务 ID 查询。多个任务可使用批量查询任务。
状态与结果
| 状态 | 含义 |
|---|---|
NOT_START | 任务已创建，尚未开始处理。 |
QUEUED | 任务正在排队。 |
ON_QUEUE | 排队中。 |
SUCCESS | 任务成功，读取对应类型的结果。 |
FAILED | 任务失败，查看任务返回的错误信息。 |
提交响应中的 status: SUCCESS 表示请求受理成功，不代表异步任务已经完成。查询响应最外层的 code: success 表示查询请求成功；任务状态读取 data.status。音乐生成或异步上传任务完成后，音轨位于 data.data.data.musics[]。其中每条音轨的 musicId 用于后续操作，audioUrl 指向音频；没有标题时，title 可能为 null。其他任务类型的结果字段可能不同，不能直接套用该结构。
回调通知
提交请求时可选填 hookUrl，接收平台转发的任务通知。回调地址只支持 80、443、8080 和 8443 端口。
未填写 hookUrl 时，可主动查询任务；状态更新可能存在延迟。填写回调后仍可使用查询接口获取结果。回调配置以提交请求中的 hookUrl 为准，不要使用查询响应中的 data.hookUrl 判断回调地址。