跳转到主要内容
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9"
    }
  ]
}
'
{
  "id": "021773297205999example"
}
使用此端点可以从文本，或从文本加参考图像启动一个 ByteDance Seedance 视频任务。请求会立即返回一个任务 id，而渲染会异步继续进行。

​
选择当前模型路径

  • 使用 Models page 查看当前可用模型及其标识符。
  • 对于此路由，使用 doubao-seedance-1-5-pro-251215 作为当前生产示例。
  • 同一个当前模型可通过统一的 content 数组同时处理纯文本请求和图像引导请求。

​
任务流程

1

构建 content 数组

先放置主要文本指令，仅当你需要首帧或末帧引导时再添加图像项。
2

提交任务

保存返回的任务 id。如果你希望进行推送交付，请在创建任务时设置 callback_url。
3

轮询直到输出返回

调用 ByteDance Video Query，直到任务完成且出现 content.video_url。

​
已知封装行为

Volcengine 和 Seedance 将这一系列能力文档化为“先创建再查询”的异步工作流。CometAPI 保留了相同的任务模式，但为你提供了一个统一的基础 URL 和一个 API key。
在 2026-03-12 的实际验证期间，此路由可以访问，但对于标准 JSON 示例仍返回服务端 JSON 解析错误。请将此处的 OpenAPI 示例视为实际封装参考，并在开发早期尽早验证你的 payload。

授权

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

请求体

application/json
​
model
string
必填

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

示例:

"doubao-seedance-1-5-pro-251215"

​
content
object[]
必填

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

​
callback_url
string

Optional webhook URL for task status notifications.

响应

200 - application/json

Task accepted.

​
id
string
必填

Task id for later polling.