Skip to main content
GET
List Video Generation Tasks

Authorizations

Authorization
string
header
required

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

Query Parameters

page_num
integer | null
default:1

The page number of the results.

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

The number of results displayed per page.

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

Filter parameter to query tasks by status.

  • queued: Tasks in queue.
  • running: Running tasks.
  • cancelled: Cancelled tasks.
  • succeeded: Successful tasks.
  • failed: Failed tasks.
Available options:
queued,
running,
cancelled,
succeeded,
failed
filter.task_ids
string[] | null

Video generation task ID, exact search, supports searching multiple task IDs simultaneously. Pass by repeating the parameter name, e.g.: filter.task_ids=id1&filter.task_ids=id2.

filter.model
string | null

Unlike the response parameter, this field is the inference endpoint ID used by the task, exact search.

filter.service_tier
enum<string> | null
default:default

The service tier used to process the task. default means online inference, flex means offline inference.

Available options:
default,
flex

Response

Query successful, returns a list of video generation tasks matching the filter criteria.

items
object[]

The list of video generation tasks found.

total
integer

The number of tasks matching the filter criteria.