批量查询任务

POST

https://api.deerapi.com/suno/fetch

获取 Suno 数据

此 API 端点用于使用 HTTP POST 请求从 Suno 任务中获取响应。

请求正文

{ “ids”： [“task_1”], “action”： “MUSIC"}

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.deerapi.com/suno/fetch' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ids": [
        "task_1",
        "task_2",
        "task_3"
    ],
    "action": "MUSIC" // or LYRICS
}'

响应示例

{
    "code": "success",
    "message": "",
    "data": [
        {
            "task_id": "346c5d10-a4a1-4f49-a851-66a7dae6cfaf",
            "notify_hook": "",
            "action": "MUSIC",
            "status": "IN_PROGRESS",
            "fail_reason": "",
            "submit_time": 1716191749,
            "start_time": 1716191786,
            "finish_time": 0,
            "progress": "0%",
            "data": [
                {
                    "id": "e9893d04-6a63-4007-8473-64b706eca4d1",
                    "title": "Electric Dance Party",
                    "status": "streaming",
                    "metadata": {
                        "tags": "club banger high-energy edm",
                        "prompt": "[Verse]\nEverybody in the place\nLet's go\nJump and dance\nFeel the rhythm\nLose control (ooh-yeah!)\nHands up in the air\nIt's time to show\nMove your body like you're on a roll\n\nShake it to the left\nShake it to the right\nFeel the bass\nFeel the beat\nAll night (ooh-yeah!)\nMiku's in the house\nGonna set the stage on fire\nGet ready for a wild ride\nIt's our desire\n\n[Verse 2]\nLights are flashing\nColors everywhere (ooh-yeah!)\nFeel the energy\nIt's in the air\nWe're unstoppable\nNothing can bring us down\nDancing to the beat\nThe whole world around",
                        "duration": null,
                        "error_type": null,
                        "error_message": null,
                        "audio_prompt_id": null,
                        "gpt_description_prompt": "miku dance"
                    },
                    "audio_url": "https://audiopipe.suno.ai/?item_id=e9893d04-6a63-4007-8473-64b706eca4d1",
                    "image_url": "https://cdn1.suno.ai/image_e9893d04-6a63-4007-8473-64b706eca4d1.png",
                    "video_url": "",
                    "model_name": "chirp-v3",
                    "image_large_url": "https://cdn1.suno.ai/image_large_e9893d04-6a63-4007-8473-64b706eca4d1.png",
                    "major_model_version": "v3"
                },
                {
                    "id": "fe69611b-fc72-4f6e-b476-5eef0b88c2e3",
                    "title": "Electric Dance Party",
                    "status": "streaming",
                    "metadata": {
                        "tags": "club banger high-energy edm",
                        "prompt": "[Verse]\nEverybody in the place\nLet's go\nJump and dance\nFeel the rhythm\nLose control (ooh-yeah!)\nHands up in the air\nIt's time to show\nMove your body like you're on a roll\n\nShake it to the left\nShake it to the right\nFeel the bass\nFeel the beat\nAll night (ooh-yeah!)\nMiku's in the house\nGonna set the stage on fire\nGet ready for a wild ride\nIt's our desire\n\n[Verse 2]\nLights are flashing\nColors everywhere (ooh-yeah!)\nFeel the energy\nIt's in the air\nWe're unstoppable\nNothing can bring us down\nDancing to the beat\nThe whole world around",
                        "duration": null,
                        "error_type": null,
                        "error_message": null,
                        "audio_prompt_id": null,
                        "gpt_description_prompt": "miku dance"
                    },
                    "audio_url": "https://audiopipe.suno.ai/?item_id=fe69611b-fc72-4f6e-b476-5eef0b88c2e3",
                    "image_url": "https://cdn1.suno.ai/image_fe69611b-fc72-4f6e-b476-5eef0b88c2e3.png",
                    "video_url": "",
                    "model_name": "chirp-v3",
                    "image_large_url": "https://cdn1.suno.ai/image_large_fe69611b-fc72-4f6e-b476-5eef0b88c2e3.png",
                    "major_model_version": "v3"
                }
            ]
        }
    ]
}

请求参数

Header 参数

Authorization

string

必需

示例值:

Bearer {{api-key}}

Body 参数application/json

ids

array[string]

必需

action

string

必需

操作：MUSIC、LYRICS

示例

返回响应

🟢200Batch task fetch

application/json

Body

code

string

必需

API请求的响应状态码

message

string

响应消息

必需

data

array [object {10}]

包含主要数据的数组

必需

task_id

string

任务的唯一标识符

可选

notify_hook

string

可选

任务完成或状态变更时的回调通知URL (webhook)

action

string

任务执行的动作类型

可选

status

string

任务的当前状态

可选

fail_reason

string

可选

如果任务失败，此处会显示失败原因

submit_time

integer

可选

任务提交时间的时间戳 (Unix timestamp, 秒级)

start_time

integer

可选

任务开始处理的时间戳 (Unix timestamp, 秒级)

finish_time

integer

可选

任务完成的时间戳 (Unix timestamp, 秒级)

progress

string

可选

任务的完成进度百分比

data

array [object {10}]

可选

包含任务具体结果的数组

修改于 2025-05-27 06:24:45

查询单个任务

生成音乐

批量查询任务

获取 Suno 数据#

请求正文#

请求参数

返回响应

获取 Suno 数据

请求正文