批量查询 Suno 任务

POST

/suno/fetch

按任务 ID 列表批量查询生成状态与结果。
请求体: {"ids":["task_xxx","task_yyy"]}（或单任务: {"task_id":"task_xxx"}）。
响应格式: {"code":"success","data":[<item>...]}。

每个 item 包含 task_id、status、action、fail_reason、progress

成功时内层 data.media[] 包含生成的音频/图片 URL 列表

data.media[].suno_audio_id 是后续编辑操作（延展/MIDI/WAV等）的音频标识

注意：suno_audio_id 不是 task_id，两者不同

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

Authorization: ********************

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

批量查询结果（含媒体列表）

Bodyapplication/json

🟠400

🟠401

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://aiapi114.com/suno/fetch' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{}'

响应示例

200 - 示例 1

{
    "code": "string",
    "data": [
        {
            "action": "string",
            "data": {
                "action": "string",
                "audio_url": "string",
                "image_url": "string",
                "media": [
                    {
                        "content_type": "string",
                        "duration": 0,
                        "expires_in": 0,
                        "index": 0,
                        "size": 0,
                        "suno_audio_id": "string",
                        "title": "string",
                        "type": "string",
                        "url": "string"
                    }
                ],
                "status": "string",
                "task_id": "string"
            },
            "fail_reason": "string",
            "finish_time": 0,
            "progress": "string",
            "result_url": "string",
            "start_time": 0,
            "status": "string",
            "submit_time": 0,
            "task_id": "string"
        }
    ],
    "message": "string"
}

查询视频任务

查询单个 Suno 任务