Skip to main content
GET
request

Authorizations

Authorization
string
header
required

Pass Authorization: Bearer <token> in the request header.

Headers

Content-Type
string
default:application/json

Request content type.

Path Parameters

id
string
required

The ID of the video generation task you need to query.

Note: The above parameters are Query String Parameters, passed in the URL string.

Response

response

id
string

Video generation task ID.

model
string

The model name and version used by the task, in model_name-version format.

status
enum<string>

Task status and related information:

  • queued: In queue.
  • running: Task running.
  • cancelled: Task cancelled, automatically deleted after 24h (only queued tasks can be cancelled).
  • succeeded: Task successful.
  • failed: Task failed.
  • expired: Task timed out.`: Task failed.
  • expired: Task timed out.
Available options:
queued,
running,
cancelled,
succeeded,
failed,
expired
error
object | null

Error message. Returns null on success, returns error data on failure.

created_at
integer

Unix timestamp (seconds) of task creation time.

updated_at
integer

Unix timestamp (seconds) of the current status update time.

content
object

The output content of the video generation task.

seed
integer

The seed integer value used for this request.

resolution
string

The resolution of the generated video.

ratio
string

The aspect ratio of the generated video.

duration
integer

The duration of the generated video, in seconds.

Note: Only one of duration and frames will be returned. If frames was not specified in the task creation, duration is returned.

frames
integer

The number of frames of the generated video.

Note: Only one of duration and frames will be returned. If frames was specified in the task creation, frames is returned.

framespersecond
integer

The frame rate of the generated video.

generate_audio
boolean

Whether the generated video contains synchronized audio. Only returned for seedance 2.0 & 2.0 fast, seedance 1.5 pro.

  • true: The output video contains synchronized audio.
  • false: The output video has no audio.
tools
object[]

The tools actually used by the model for this request. Not returned if no tools were used.

safety_identifier
string

Unique identifier of the end user. If this parameter was set when creating the video generation task, the API returns it as-is.

priority
integer

The execution priority of the current request.

draft
boolean

Whether the generated video is a Draft video. Only returned for seedance 1.5 pro.

  • true: The current output is a Draft video.
  • false: The current output is a normal video.
draft_task_id
string

Draft video task ID. Returned when generating the final video based on a Draft video.

service_tier
string

The actual service tier used to process the task.

execution_expires_after
integer

Task timeout threshold, in seconds.

usage
object

Token usage for this request.