批量获取任务

主站环境

https://n.lconai.com

POST

/suno/fetch

批量查询任务，ids 使用提交响应中的任务 ID。外层 data 为任务数组，按 task_id 关联；以每项 status 判断生成结果。

请求参数

Authorization

Header 参数

Body 参数application/json

示例

批量查询（音乐与歌词任务）查询一个任务（数组格式）

示例值请替换为实际参数。

{
    "ids": [
        "task_music_example",
        "task_lyrics_example"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

批量查询（音乐与歌词任务）查询一个任务（数组格式）

curl --location 'https://n.lconai.com/suno/fetch' \
--header 'Authorization: {{Authorization}}' \
--header 'Content-Type: application/json' \
--data '{
    "ids": [
        "task_music_example",
        "task_lyrics_example"
    ]
}'

返回响应

🟢200批量任务查询成功

application/json

外层 data 为任务数组；每个任务有独立 status 和 data。示例为结构演示，不是实时查询结果。

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
        },
        {
            "created_at": 1792972800,
            "updated_at": 1792972890,
            "task_id": "task_pending_example",
            "platform": "sunoapi",
            "status": "IN_PROGRESS",
            "fail_reason": "",
            "submit_time": 1792972800,
            "finish_time": 0,
            "progress": "",
            "data": null,
            "action": "MUSIC",
            "start_time": 0
        },
        {
            "created_at": 1792972800,
            "updated_at": 1792972890,
            "task_id": "task_failed_example",
            "platform": "sunoapi",
            "status": "FAILURE",
            "fail_reason": "上游返回的实际失败原因",
            "submit_time": 1792972800,
            "finish_time": 1792972890,
            "progress": "",
            "data": null,
            "action": "MUSIC",
            "start_time": 0
        }
    ]
}

修改于 2026-10-28 12:58:41

生成歌词

查询单个任务