火山方舟大模型服务平台
产品简介
快速入门-调用模型服务
快速入门-速览平台功能
模型介绍
模型列表
API 参考
获取 API Key 并配置
安装及升级 SDK
对话(Chat)-文本 API
POST
视频生成 API
图片生成 API
POST
向量化 API
Powered by Hapydev
查询视频生成任务列表开发中
GEThttps://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks?page_num={page_num}&page_size={page_size}&filter.status={filter.status}&filter.task_ids={filter.task_ids}&filter.model={filter.model}
创建时间: 2025-05-31 21:26
请求参数
Header 参数
参数名示例值是否必填参数类型描述说明
Content-Typeapplication/json是string-
AuthorizationBearer {{ARK_API_KEY}}是string-
Query 参数
参数名示例值是否必填参数类型描述说明
page_num{page_num}是string取值范围：[1, 500] 返回结果的页码。
page_size{page_size}是string取值范围：[1, 500] 返回结果的每页的结果数量。
filter.status{filter.status}是string过滤参数，查询某个任务状态。 queued：排队中的任务。 running：运行中任务。 cancelled：取消的任务，只能查询到24h内取消的任务。取消任务超出24h，会被删除。 succeeded： 成功的任务。 failed：失败的任务。
filter.task_ids{filter.task_ids}是string视频生成任务 ID，精确搜索，支持同时搜索多个任务 ID。
filter.model{filter.model}是string与返回参数不同，该字段为任务使用的推理接入点 ID，精确搜索。
响应示例
成功
HTTP状态码：200
内容格式：JSON
数据结构
itemsarray<object>
必填
查询到的视频生成任务列表。
modelstring
必填
与请求参数含义不同，此处含义为任务使用的 {模型名称}-{版本}
statusstring
必填
任务状态，以及相关的信息： queued：排队中。 running：任务运行中。 cancelled：取消任务，取消状态24h自动删除（只支持排队中状态的任务被取消）。 succeeded： 任务成功。 failed：任务失败。
created_atstring
必填
任务创建时间的 Unix 时间戳（秒）。
updated_atstring
必填
任务当前状态更新时间的 Unix 时间戳（秒）。
contentobject
必填
当视频生成任务完成，会输出该字段，包含生成视频下载的 URL。
video_urlstring
必填
生成视频的URL。为保障信息安全，生成的视频会在24小时后被清理，请及时转存。
usageobject
必填
本次请求的 token 用量。
completion_tokensinteger
必填
模型生成的 token 数量。
total_tokensintegerinteger
可选
视频生成模型不统计输入 token，输入 token 为 0，故 total_tokens=completion_tokens。
idstring
可选
视频生成任务 ID 。
totalinteger
必填
符合筛选条件的任务数量。
响应示例
{
  "total": 12,
  "items": [
    {
      "id": "cgt-20250331175019-68d9t",
      "model": "doubao-seaweed-241128",
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seaweed/doubao-seaweed-2100566469-****.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTY****%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250331T095113Z&X-Tos-Expires=86400&X-Tos-Signature=***&X-Tos-SignedHeaders=host"
      },
      "usage": {
        "completion_tokens": 108900,
        "total_tokens": 108900
      },
      "created_at": 1743414619,
      "updated_at": 1743414673
    },
    {
      "id": "cgt-20250331154139-v8x4t",
      "model": "doubao-seaweed-241128",
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seaweed/doubao-seaweed-2100566469-****.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTY****%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250331T095113Z&X-Tos-Expires=86400&X-Tos-Signature=***&X-Tos-SignedHeaders=host"
      },
      "usage": {
        "completion_tokens": 82280,
        "total_tokens": 82280
      },
      "created_at": 1743406900,
      "updated_at": 1743406940
    },
    {
      "id": "cgt-20250331154139-dgkmr",
      "model": "doubao-seaweed-241128",
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seaweed/doubao-seaweed-2100566469-****.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTY****%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250331T095113Z&X-Tos-Expires=86400&X-Tos-Signature=***&X-Tos-SignedHeaders=host"
      },
      "usage": {
        "completion_tokens": 82280,
        "total_tokens": 82280
      },
      "created_at": 1743406900,
      "updated_at": 1743406946
    }
  ]
}
最后更新: 3 周前
上一页
GET查询视频生成任务 API
下一页
POST取消或删除视频生成任务