Skip to main content
GET
List video generation tasks

Authorizations

Authorization
string
header
required

A workspace API key beginning with gengen_live_.

Query Parameters

page_num
integer
default:1

Page number to return.

Required range: 1 <= x <= 500
page_size
integer
default:20

Number of tasks per page.

Required range: 1 <= x <= 500
filter.status
enum<string>

Filter by normalized task status.

Supported values:

  • queued — waiting to start
  • running — currently processing
  • cancelled — cancelled before completion
  • succeeded — completed successfully
  • failed — stopped with an error
Available options:
queued,
running,
cancelled,
succeeded,
failed
filter.task_ids
string[]

Public task IDs to include. Repeat this query parameter to provide multiple IDs.

filter.model
string

Exact public model ID.

filter.service_tier
enum<string>

Filter by the saved service tier.

Supported values:

  • default — standard online processing
  • flex — flexible offline processing when supported
Available options:
default,
flex

Response

A paginated list of persisted video tasks.

items
object[]
required
page_num
integer
required
Required range: x >= 1
page_size
integer
required
Required range: 1 <= x <= 500
total
integer
required
Required range: x >= 0