Query Video Generation Task

Version: v1.0.0 | Last Updated: 2026-06-11
This platform fully supports the Doubao Seedance series video generation API. Requests and responses are transparently proxied, and all parameter semantics remain consistent with the official API.

Retrieve the current status and result of a video generation task by its ID.

GET https://platform.dataeyes.ai/seedance/api/v3/contents/generations/tasks/{id}

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The task ID returned from the Create Task endpoint.

Retention & URL Validity

Task records are retained for 7 days from task creation. After 7 days, the task record is permanently deleted and can no longer be queried.

Video download URLs in the response are valid for 24 hours after each query. If a URL has expired, simply re-query the task to obtain a fresh URL (provided the task record is still within the 7-day retention window).

Response Fields

Field	Type	Description
`id`	string	Unique task identifier.
`model`	string	The model Endpoint ID used for this task.
`status`	string	Current task status. See Task Status Values.
`error`	object	Present only when `status` is `"failed"`. Contains error details.
`error.code`	string	Machine-readable error code (e.g., `"content_policy_violation"`, `"internal_error"`).
`error.message`	string	Human-readable error description.
`created_at`	integer	Unix timestamp (seconds) when the task was created.
`updated_at`	integer	Unix timestamp (seconds) when the task was last updated.
`content`	object	Present when `status` is `"succeeded"`. Contains the generation output.
`content.video_url`	string	HTTPS URL to download the generated video. Valid for 24 hours; re-query for a fresh URL.
`content.last_frame_url`	string	HTTPS URL to download the last frame as an image. Only present when `return_last_frame` was `true` in the creation request. Valid for 24 hours.
`seed`	integer	The random seed used for generation. Can be reused for reproducible results.
`resolution`	string	The output resolution used (e.g., `"480p"`, `"720p"`, `"1080p"`).
`ratio`	string	The output aspect ratio used (e.g., `"16:9"`, `"9:16"`).
`duration`	integer	The output video duration in seconds. Present when the task was specified using `duration`. Mutually exclusive with `frames`.
`frames`	integer	The output video frame count. Present when the task was specified using `frames`. Mutually exclusive with `duration`.
`framespersecond`	integer	The output video frame rate (frames per second).
`generate_audio`	boolean	Whether synchronized audio was generated with the video.
`tools`	object[]	Tools that were enabled for this task (e.g., `[{"type": "web_search"}]`).
`safety_identifier`	string	The safety policy identifier applied to this task, if any.
`priority`	integer	The priority level assigned to this task (Seedance 2.0 only).
`draft`	boolean	Whether this task was a draft-quality generation.
`draft_task_id`	string	If this task was an upgrade from a draft, the original draft task ID.
`service_tier`	string	The service tier used for this task (`"default"` or `"flex"`).
`execution_expires_after`	integer	The expiration timeout (in seconds) that was set for this task.
`usage`	object	Token usage and billing information.
`usage.completion_tokens`	integer	Number of tokens consumed by this task. This represents the billing unit for the generation. Note: Seedance 2.0 models have a minimum token charge; short or simple generations may still incur the minimum token amount.
`usage.total_tokens`	integer	Total tokens consumed. For video generation tasks, this equals `completion_tokens` (there are no separate input tokens).
`usage.tool_usage`	object	Tool-specific usage information, if tools were enabled.
`usage.tool_usage.web_search`	object	Web search tool usage details. Present when `tools` included `web_search`.

Task Status Values

Status	Terminal	Description
`queued`	No	The task is waiting in the queue to be processed.
`running`	No	The task is currently being processed by the generation engine.
`succeeded`	Yes	The task completed successfully. The `content` field contains the video URL.
`failed`	Yes	The task encountered an error. The `error` field contains details.
`cancelled`	Yes	The task was cancelled by the user. Cancelled records are automatically deleted after 24 hours.
`expired`	Yes	The task exceeded its `execution_expires_after` timeout while queued.

Response Example

Succeeded Task

{
  "id": "task_abc123def456",
  "model": "seedance-2.0",
  "status": "succeeded",
  "created_at": 1718100000,
  "updated_at": 1718100120,
  "content": {
    "video_url": "https://cdn.example.com/generated/video_abc123.mp4"
  },
  "seed": 42,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 25,
  "generate_audio": true,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "usage": {
    "completion_tokens": 1500,
    "total_tokens": 1500
  }
}

Failed Task

{
  "id": "task_xyz789",
  "model": "seedance-2.0",
  "status": "failed",
  "error": {
    "code": "content_policy_violation",
    "message": "The generated content was flagged by the safety filter. Please revise your prompt."
  },
  "created_at": 1718100000,
  "updated_at": 1718100045,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "usage": {
    "completion_tokens": 0,
    "total_tokens": 0
  }
}

Queued Task

{
  "id": "task_pending789",
  "model": "seedance-1.5-pro",
  "status": "queued",
  "created_at": 1718100000,
  "updated_at": 1718100000,
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 10,
  "generate_audio": true,
  "draft": false,
  "service_tier": "default",
  "execution_expires_after": 172800
}

02-Query-Video-Generation-Task

Query Video Generation Task#

Path Parameters#

Retention & URL Validity#

Response Fields#

Task Status Values#

Response Example#

Succeeded Task#

Failed Task#

Queued Task#