查询单个任务

查询单个任务，task_id 使用提交响应中的任务 ID。外层 data 为任务对象；以 status 判断生成结果，失败时查看 fail_reason。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200单个任务查询成功

application/json

外层 data 是任务对象。读取任务 status 判断是否生成完成；该状态与外层查询 code 相互独立。

Bodyapplication/json

示例

音乐任务（生成完成）歌词任务（创作完成）生成中（尚未完成）任务失败（查看失败原因）

{
    "code": "success",
    "message": "",
    "data": {
        "created_at": 1792972800,
        "updated_at": 1792972890,
        "task_id": "task_music_example",
        "platform": "sunoapi",
        "status": "SUCCESS",
        "fail_reason": "",
        "submit_time": 1792972800,
        "finish_time": 1792972890,
        "progress": "100%",
        "data": [
            {
                "id": "clip_music_example",
                "audio_url": "https://cdn.example.com/suno/song.mp3",
                "image_url": "https://cdn.example.com/suno/cover.jpg",
                "title": "夏日海岸",
                "text": "[Chorus]\n我们向着明天奔跑",
                "metadata": {
                    "tags": "mandopop, acoustic guitar"
                }
            }
        ],
        "action": "MUSIC",
        "start_time": 1792972800
    }
}

请求参数

请求示例代码

返回响应