火山方舟大模型服务平台

产品简介

快速入门-调用模型服务

快速入门-速览平台功能

模型介绍

模型列表

API 参考

获取 API Key 并配置

安装及升级 SDK

对话(Chat)-文本 API

POST

视频生成 API

图片生成 API

POST

向量化 API

查询视频生成任务 API开发中

GEThttps://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/:id

创建时间: 2025-05-31 21:20

请求参数

路径参数

参数名	示例值	是否必填	参数类型	描述说明
id	<string>	-	-	您需要查询的视频生成任务的 ID 。

Header 参数

参数名	示例值	是否必填	参数类型	描述说明
Content-Type	application/json	是	string	-
Authorization	Bearer {{ARK_API_KEY}}	是	string	-

响应示例

成功

HTTP状态码：200

内容格式：JSON

数据结构

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_tokensinteger

必填

视频生成模型不统计输入 token，输入 token 为 0，故 total_tokens=completion_tokens。

idstring

可选

视频生成任务 ID 。

errorobject

可选

错误提示信息，任务成功返回null，任务失败时返回错误数据，错误信息具体参见错误处理。

codestring

可选

错误码。

messagestring

可选

错误提示信息。

响应示例

{
  "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
}

最后更新: 3 周前

POST创建视频生成任务 API

GET查询视频生成任务列表