Single task query - API Doc-CometAPI

Request

Path Params

task_id

string

required

task id

Header Params

Authorization

string

required

Example:

Bearer {{api-key}}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

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