Skip to main content
GET
/
byteplus
/
api
/
v3
/
contents
/
generations
/
tasks
List Video Generation Tasks
curl --request GET \
  --url https://api.powertokens.ai/byteplus/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>'
{
  "total": 2,
  "items": [
    {
      "id": "cgt-2025******-****",
      "model": "dreamina-seedance-2-0-260128",
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-content-generation-ap-southeast-1.tos-ap-southeast-1.volces.com/seedance-1-0-pro/****.mp4"
      },
      "usage": {
        "completion_tokens": 108900,
        "total_tokens": 108900
      },
      "created_at": 1743414619,
      "updated_at": 1743414673,
      "seed": 10,
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "framespersecond": 24,
      "service_tier": "default",
      "execution_expires_after": 172800,
      "generate_audio": true,
      "draft": false,
      "priority": 0
    },
    {
      "id": "cgt-2026****-****",
      "model": "doubao-seedance-2-0-260128",
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/xxx"
      },
      "usage": {
        "completion_tokens": 49761,
        "total_tokens": 49761
      },
      "created_at": 1779353985,
      "updated_at": 1779354268,
      "seed": 68292,
      "resolution": "480p",
      "ratio": "3:4",
      "duration": 5,
      "framespersecond": 24,
      "service_tier": "default",
      "execution_expires_after": 172800,
      "generate_audio": true,
      "draft": false,
      "priority": 0
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
page_num
integer | null
default:1

Page number of the returned results.

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

Number of results per page.

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

Filter parameter used to query tasks with a specific status.

  • queued: Task in queue.
  • running: Task in progress.
  • cancelled: Cancelled task.
  • succeeded: Successful task.
  • failed: Failed task.
Available options:
queued,
running,
cancelled,
succeeded,
failed
​
filter.task_ids
string[] | null

Video generation task ID for exact search. Supports batch search by repeating the parameter name, for example: filter.task_ids=id1&filter.task_ids=id2.

​
filter.model
string | null

Model ID or endpoint ID for exact search. Only one input is supported. When the permission of your API key is Custom, manually enter the model ID or endpoint ID to query. A model resource generally corresponds to one preconfigured inference endpoint and multiple custom inference endpoints. Model ID is bound to the preconfigured inference endpoint.When a model ID is entered, video generation tasks initiated by calling this preconfigured inference endpoint will be returned.

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

Service tier used for task processing. default means online inference mode, and flex means offline inference mode.

Available options:
default,
flex

Response

Query succeeded. Returns matching video generation tasks.

​
items
object[]

List of found video generation tasks.

​
total
integer

Number of tasks that meet the filter conditions.