查询单个任务

GET

https://api.deerapi.com/suno/fetch/{task_id}

该端点发出 HTTP GET 请求，以检索由 task_id 标识的特定任务的详细信息。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.deerapi.com/suno/fetch/' \
--header 'Authorization: Bearer {{api-key}}'

响应示例

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "dcb812bd-40c5-4907-836e-3a7aa9a2e546",
    "action": "MUSIC",
    "status": "NOT_START",
    "fail_reason": "",
    "submit_time": 1747203819,
    "start_time": 1747203819,
    "finish_time": 0,
    "progress": "0%",
    "data": null
  }
}

请求参数

Path 参数

task_id

string

必需

任务ID，可在生成音乐响应中查看

Header 参数

Authorization

string

必需

示例值:

Bearer {{api-key}}

返回响应

🟢200Successful Response

application/json

Body

code

string

任务状态

可选

message

string

可选

提示信息，成功时通常为空，失败时可包含错误详情

data

object

可选

业务数据主体，包含任务的具体信息

task_id

string

可选

任务的唯一标识符 (UUID)

action

string

任务类型或操作类型

可选

status

string

任务当前状态

可选

fail_reason

string

可选

任务失败原因，仅在 status 为 FAILED 时有效

submit_time

integer

可选

任务提交时间戳 (Unix时间戳，单位：秒)

start_time

integer

可选

任务实际开始处理的时间戳 (Unix时间戳，单位：秒)

finish_time

integer

可选

任务完成的时间戳 (Unix时间戳，单位：秒)

progress

string

可选

任务处理进度，百分比表示

data

null

任务的输出结果数据

可选

修改于 2025-05-27 06:22:04

歌曲拼接

批量查询任务