Skip to main content
GET
Query Task

Query Task

Query the task status, progress, and result video URL based on the task_id returned by Create Video.

Method and Path

Request Example

Response Example

Authentication

Path Parameters

task_id
string
required
Video generation task ID, consistent with the task_id returned by the creation endpoint.

Response

code
string
Response code, success on success.
data.task_id
string
Task ID.
data.status
string
Task status: SUBMITTED, IN_PROGRESS, SUCCESS, FAILURE.
data.progress
string
Progress string, such as 50% or 100%.
data.fail_reason
string
Reason for failure, present only when status=FAILURE.
data.data.status
string
Upstream native status: queued, pending, processing, succeeded, failed.
data.data.content.video_url
string
Generated video URL (usually a temporary signed link, valid for about 12 hours by default).
data.data.usage.total_tokens
integer
Token usage related to billing.