Vidu Query Creations API

Query Vidu video generation task status and results by task ID. Creation URLs are valid for 24 hours.

Query task status and generation results using the task_id returned when creating a task. Creation URLs, cover URLs, and watermarked URLs are all valid for 24 hours.

Applies to all Vidu async tasks, including text-to-video, image-to-video, reference-to-video, start-end frame, lip sync, and video extend.

Base URL

https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) Authenticate using a Bearer Token. Format: Authorization: Bearer sk-xxxxxx

Endpoints

GET `/vidu/ent/v2/tasks/{id}/creations`

Query Creations

Query processing status and the list of creations by task ID.

Path Parameters

Name	Type	Required	Description
`id`	string	Yes	Task ID returned by a successful create-task request

Headers

Name	Type	Required	Description
`Authorization`	string	Yes	Request authentication. Format: `Bearer sk-xxxxxx`

Responses

200: Task queried successfully

Content-Type: application/json

400: Bad request / invalid parameters

Content-Type: application/json

429: Rate limit exceeded

Content-Type: application/json

Request Example

curl -X GET "https://api.autorouter.top/vidu/ent/v2/tasks/{your_id}/creations" \
  -H "Authorization: Bearer sk-xxxxxx"

Response Example

{
  "id": "your_task_id",
  "state": "success",
  "err_code": "",
  "credits": 4,
  "payload": "",
  "creations": [
    {
      "id": "your_creations_id",
      "url": "your_generated_results_url",
      "cover_url": "your_generated_results_cover_url",
      "watermarked_url": "your_generated_results_watermarked_url"
    }
  ]
}

Response fields:

Name	Type	Description
`id`	string	Task ID
`state`	string	Processing status. Enum: `created` (created), `queueing` (queued), `processing` (in progress), `success` (succeeded), `failed` (failed). Typical poll flow: `created` / `queueing` → `processing` → `success` / `failed`
`err_code`	string	Error code. Returned when the task fails
`credits`	integer	Credits consumed by this task
`payload`	string	Passthrough parameter from the original request
`bgm`	boolean	Whether BGM was used for this task
`off_peak`	boolean	Whether off-peak mode was used for this task
`creations`	array	List of generation results; usually non-empty only on success
`creations[].id`	string	Creation ID
`creations[].url`	string	Creation URL, valid for 24 hours
`creations[].cover_url`	string	Cover URL, valid for 24 hours
`creations[].watermarked_url`	string	Watermarked creation URL, valid for 24 hours

Error Handling

HTTP 401 / 403 Auth Errors

401 Unauthorized: API Key invalid or expired
403 Forbidden: API Key has no access to this resource

HTTP 404 Task Not Found

May be returned when the task ID is invalid or does not belong to the current account.

Task `failed` Status

See err_code. When a task fails, AutoRouter automatically refunds the billed quota. Check refund records in the logs page.

Query Creations

On this page