跳转到主要内容
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "021773297205999example",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated.mp4"
  },
  "created_at": 1773297205,
  "updated_at": 1773297260,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24
}
在你创建 ByteDance 即梦任务后，使用此端点。它不会启动渲染。它只会报告当前任务状态，并在任务完成时返回生成的视频 URL 和输出元数据。

​
关注这些字段

  • 当前提供商状态对应的 status
  • 渲染完成时的 content.video_url
  • 如果你的应用需要输出元数据，则关注 resolution、duration、ratio 和 framespersecond

​
轮询循环

1

先创建任务

从 ByteDance 视频生成 开始。
2

按任务 id 轮询

持续调用此端点，直到状态进入终态。
3

持久化结果

当出现 content.video_url 时，如果你需要长期保留，请将结果复制到你自己的存储中。

​
结果 URL

ByteDance 工作流仍然是先创建，再按任务 id 查询。CometAPI 保留了这一结构，并统一了身份验证。请将返回的视频 URL 视为交付 URL，而不是永久存储。

授权

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

路径参数

​
id
string
必填

Task id returned by the create endpoint.

响应

200 - application/json

Current task state.

​
id
string
必填
​
model
string
必填
​
status
string
必填

Provider task status.

​
created_at
integer
必填
​
updated_at
integer
必填
​
content
object
​
usage
object
​
seed
integer
​
resolution
string
​
duration
integer
​
ratio
string
​
framespersecond
integer