跳转到主要内容
GET
/
byteplus
/
api
/
v3
/
contents
/
generations
/
tasks
查询视频生成任务列表
curl --request GET \
  --url https://api.powertokens.ai/byteplus/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>'
{
  "total": 2,
  "items": [
    {
      "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": 109586,
        "total_tokens": 109586
      },
      "created_at": 1779354227,
      "updated_at": 1779354426,
      "seed": 70172,
      "resolution": "720p",
      "ratio": "4:3",
      "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
    }
  ]
}

授权

​
Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>。

查询参数

​
page_num
integer | null
默认值:1

返回结果的页码。

必填范围: 1 <= x <= 500
​
page_size
integer | null
默认值:20

每页显示的结果数量。

必填范围: 1 <= x <= 500
​
filter.status
enum<string> | null

过滤参数，查询某个任务状态。

  • queued：排队中的任务。
  • running：运行中任务。
  • cancelled：取消的任务。
  • succeeded：任务的成功。
  • failed：失败的任务。
可用选项:
queued,
running,
cancelled,
succeeded,
failed
​
filter.task_ids
string[] | null

视频生成任务 ID，精确搜索，支持同时搜索多个任务 ID。需通过重复参数名的方式传递，例如：filter.task_ids=id1&filter.task_ids=id2。

​
filter.model
string | null

与返回参数不同，该字段为任务使用的推理接入点 ID，精确搜索。

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

处理任务使用的服务等级。default 表示在线推理模式，flex 表示离线推理模式。

可用选项:
default,
flex

响应

查询成功，返回符合筛选条件的视频生成任务列表。

​
items
object[]

查询到的视频生成任务列表。

​
total
integer

符合筛选条件的任务数量。