Skip to main content
GET
/
vidu
/
ent
/
v2
/
tasks
/
{task_id}
/
creations
Query Image Task Status
curl --request GET \
  --url https://api.powertokens.ai/vidu/ent/v2/tasks/{task_id}/creations \
  --header 'Authorization: Bearer <token>'
{
  "state": "success",
  "err_code": "",
  "credits": 4,
  "payload": "",
  "creations": [
    {
      "id": "your_creations_id",
      "url": "https://example.com/generated_image.png",
      "cover_url": "https://example.com/cover_image.png"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer <token> in the request header.

Path Parameters

​
task_id
string
required

Task ID returned by the image creation endpoint (e.g., POST /vidu/v1/images/reference2image).

Response

Query successful, returns image task status information.

​
state
enum<string>

Task processing state:

  • created: Task created successfully
  • queueing: Task in queue
  • processing: Task processing
  • success: Generation successful
  • failed: Task failed
Available options:
created,
queueing,
processing,
success,
failed
​
err_code
string

Error code returned in case of failure. Empty string if no error.

​
credits
integer

The number of credits consumed by this task. Unit: credits.

​
payload
string

The payload parameter used for this call.

​
bgm
boolean

Whether to use BGM (background music) for this call.

​
off_peak
boolean

Whether to use off-peak mode for this call.

​
creations
object[]

Generated results array.