音乐生成 · 查询音乐任务
按平台任务 ID 查询任务状态与结果。
基本信息
| 字段 | 内容 |
|---|---|
| 应用编码 | music_generation |
| API 编码 | query |
| 请求方式 | GET |
| 请求路径 | /api/v1/apps/music_generation/query |
| 调用模式 | 同步 |
鉴权
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
业务参数
| 参数 | 类型 | 必填 | 默认值 | 可选值 / 范围 | 示例 | 说明 |
|---|---|---|---|---|---|---|
task_id | string | 是 | - | - | task_xxxxxxxxxxxx | 创建任务后返回的平台任务 ID。 |
响应说明
同步返回处理结果。媒体类结果可能包含 audio_url、video_url、file_url、image_url、audio_id、persona_id 等字段,具体以接口实际结果为准。
处理中示例
{
"code": 1,
"msg": "success",
"data": {
"result": {
"status": "processing"
},
"usage": {
"points_cost": 0,
"actual_points": 0
}
}
}
完成示例
{
"code": 1,
"msg": "success",
"data": {
"result": {
"task_id": "task_xxxxxxxxxxxx",
"status": "completed",
"audio_url": "https://example.com/music/audio.mp3",
"file_url": "https://example.com/music/audio.wav",
"data": [
{
"id": "audio_xxxxxxxxxxxx",
"title": "Morning API",
"audio_url": "https://example.com/music/audio.mp3"
}
]
},
"usage": {
"points_cost": 0,
"actual_points": 0
}
}
}
失败示例
{
"code": 0,
"msg": "任务处理失败,请稍后重试",
"data": null
}
音频地址说明
返回的 audio_url 形如 https://sunodownload.ai/suno/play?item_id=...,看着像播放页,实际直接返回 mp3 文件(Content-Type: audio/mpeg),可直接下载保存。
注意:
data数组里个别曲目的audio_url可能为空,遇到空值时取顶层audio_url或数组中第一个非空值。