Skip to main content
GET
/
vidu
/
ent
/
v2
/
tasks
/
{task_id}
/
creations
Query Audio 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 audio creation endpoint (e.g., POST /vidu/v1/audio/text2audio or POST /vidu/v1/audio/timing2audio).

Response

Query successful, returns audio 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.