Skip to main content
POST
/
suno
/
fetch
批量查询任务
curl --request POST \
  --url https://api.deerapi.com/suno/fetch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "example"
  ],
  "action": "example"
}
'
{
  "code": "<string>",
  "message": "<string>",
  "data": [
    {
      "task_id": "<string>",
      "notify_hook": "<string>",
      "action": "<string>",
      "status": "<string>",
      "fail_reason": "<string>",
      "submit_time": 123,
      "start_time": 123,
      "finish_time": 123,
      "progress": "<string>",
      "data": [
        {
          "id": "<string>",
          "title": "<string>",
          "status": "<string>",
          "metadata": {
            "tags": "<string>",
            "prompt": "<string>",
            "duration": null,
            "error_type": null,
            "error_message": null,
            "audio_prompt_id": null,
            "gpt_description_prompt": "<string>"
          },
          "audio_url": "<string>",
          "image_url": "<string>",
          "video_url": "<string>",
          "model_name": "<string>",
          "image_large_url": "<string>",
          "major_model_version": "<string>"
        }
      ]
    }
  ]
}
/suno/fetch 接口允许您在单个请求中同时查询多个任务的状态和结果。当您需要一次跟踪多个音乐生成、歌词创建或其他异步操作时，这比单独查询任务更高效。 使用此接口可以高效地监控多个任务并批量检索其结果，减少 API 调用次数并提高性能。

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json
​
ids
string[]
required
​
action
string
default:example
required

操作：MUSIC、LYRICS

Response

200 - application/json

Batch task fetch

​
code
string
required

API请求的响应状态码

​
message
string
required

响应消息

​
data
object[]
required

包含主要数据的数组