ByteDance 视频生成

使用 bytedance-video 端点，通过 POST /volc/v3/contents/generations/tasks 创建和管理视频生成任务，并支持灵活的参数。

POST /volc/v3/contents/generations/tasks

cURL

Text to video

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"
    }
  ]
}
'

200

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

Show child attributes

callback_url · string

Optional webhook URL for task status notifications.

响应

200 - application/json

Task accepted.

id · string · 必填

Task id for later polling.