Skip to main content
GET
Retrieve a video generation task

Authorizations

Authorization
string
header
required

A workspace API key beginning with gengen_live_.

Path Parameters

id
string
required

The public task ID returned by the create endpoint. URL-encode the ID when placing it in the path, including any colon in the provider prefix.

Response

The latest task state and outputs.

Standard task fields are listed first. Additional provider-native and legacy aliases can be appended for compatibility.

id
string
required

Public GENGEN task ID.

model
string
required

Public model ID selected for the task.

status
string
required

Task state. Common values include pending, queued, running, processing, succeeded, completed, failed, cancelled, and expired.

outputs
object
required
stage
enum<string>

Present during local reference preparation or queuing; omitted for provider-native states.

Available options:
preparingAssets,
queued,
failed
message
string

Optional informational notice for a Seedance task that is still processing more than 420 seconds after upstream creation. This notice is omitted otherwise; existing upstream passthrough messages are unchanged.

Example:

"Video generation is taking longer than usual. Seedance may be experiencing high demand. Your video is still generating."

draft
boolean

Whether this Seedance output is a draft preview.

draftTaskId
string

Public GENGEN source draft ID for a finalized video.

createdAt
string<date-time>
updatedAt
string<date-time>
statusUpdateTime
string<date-time>
failureReason
string
error

Structured task failure or a compatibility error.

created_at

Compatibility timestamp returned by a provider or legacy endpoint.

updated_at

Compatibility timestamp returned by a provider or legacy endpoint.

status_update_time

Compatibility timestamp returned by a provider or legacy endpoint.

failure_reason
string
task_id
string

Compatibility alias for id.

video_url
string<uri> | null

Compatibility alias for the first video output.

videos
string<uri>[]

Compatibility alias for outputs.videos.

enhanced_prompt
string
detail
any
task_info
any
content
any
output
any
data
any
usage
object

Model-specific usage on successful retrieval. Seedance reports token counts when supplied. Other providers publish their own fields in the corresponding task reference.

output_format
enum<string>

Compatibility-only provider field containing the effective Seedance 2.5 output format.

Available options:
mp4,
mov