创建视频生成任务

POST

/v1/videos

提交视频生成请求，支持文生视频、首帧/首尾帧图生视频、多图参考、多模态参考等模式。

参数支持两种传法：

顶层传法（推荐）：content、resolution、ratio、duration、generate_audio、watermark 等直接放在请求体顶层。

兼容写法：把上游原始参数放入 metadata 字段。

当前 new-api 兼容逻辑下，如果顶层和 metadata 同时传同名字段，metadata 中已有字段优先，顶层字段只用于补全 metadata 中缺失的同名字段。建议不要同一个参数传两份不同值。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "一个女孩在阳光下的城市街道上跳舞，镜头稳定，真实自然。",
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 5,
    "generate_audio": true,
    "watermark": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "一个女孩在阳光下的城市街道上跳舞，镜头稳定，真实自然。",
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 5,
    "generate_audio": true,
    "watermark": false
}'

返回响应

🟢200

application/json

任务创建成功，返回任务 ID

Bodyapplication/json

示例

{
    "id": "task_qghsnDbtZo7FeliS4PAA1jGQsq1X1laH",
    "task_id": "task_qghsnDbtZo7FeliS4PAA1jGQsq1X1laH",
    "object": "video",
    "model": "doubao-seedance-2-0-fast-260128",
    "status": "queued",
    "progress": 0,
    "created_at": 1778479354
}

🟠400

🟠401

🟠404

修改于 2026-06-29 05:21:56

查询视频任务状态与结果