音乐生成 · 查询音乐任务

按平台任务 ID 查询任务状态与结果。

基本信息

字段内容
应用编码music_generation
API 编码query
请求方式GET
请求路径/api/v1/apps/music_generation/query
调用模式同步

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

业务参数

参数类型必填默认值可选值 / 范围示例说明
task_idstring是--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 或数组中第一个非空值。

同类文章