Query Task

Use `GET /v1/video/generations/{task_id}` to query the status and result of a Seedance 2.0 video generation task.

GEThttps://zx1.deepwl.net/v1/video/generations/{task_id}

Request

curl https://zx1.deepwl.net/v1/video/generations/cgt-20260412163502-x8k2m \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Response

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxx",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "submit_time": 1775908082,
    "start_time": 1775908086,
    "finish_time": 0,
    "data": {
      "status": "processing",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "content": {},
      "usage": {}
    }
  }
}

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

Request Headers

Authorizationstring必填

Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.

Query Parameters

task_idstring必填

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

Request Examples

Response Examples

Response Fields

codestring

Response code, success on success.

dataobject

Task data.

task_idstring

Task ID.

statusstring

Task status: SUBMITTED, IN_PROGRESS, SUCCESS, FAILURE.

progressstring

Progress string, such as 50% or 100%.

fail_reasonstring

Reason for failure, present only when status=FAILURE.

dataobject

Upstream native data.

statusstring

Upstream native status: queued, pending, processing, succeeded, failed.

contentobject

Task result content.

video_urlstring

Generated video URL (usually a temporary signed link, valid for about 12 hours by default).

usageobject

Usage information.

total_tokensinteger

Token usage related to billing.