🎉 New Models Available: grok-4 now live!
→ Explore New Features

Single task query

GET

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

Maintainer:Not configured

This endpoint makes an HTTP GET request to retrieve the details of a specific task identified by the task_id.

Request

Path Params

task_id

string

required

task id

Header Params

Authorization

string

required

Example:

Bearer {{api-key}}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Successful Response

application/json

Body

code

string

optional

API response status code

message

string

optional

Prompt message, usually empty when successful, may contain error details when failed

data

object

optional

API response data body, including specific information about the task

task_id

string

optional

Task's unique identifier (UUID)

action

string

optional

Task type or operation type

status

string

optional

Current task status

fail_reason

string

optional

Task failure reason, only valid when status is FAILED

submit_time

integer

optional

Task submission timestamp (Unix timestamp, unit: seconds)

start_time

integer

optional

Timestamp when the task actually started processing (Unix timestamp, unit: seconds)

finish_time

integer

optional

Timestamp when the task was completed (Unix timestamp, unit: seconds)

progress

string

optional

Task processing progress, expressed as a percentage

data

null

optional

Task output result data

Example

{
  "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
  }
}

Create New Persona

Generate mp4 mv video