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
createdAt
string<date-time>
updatedAt
string<date-time>
statusUpdateTime
string<date-time>
failureReason
string
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
any