提交视频生成任务（豆包原生格式）

POST

/api/v3/contents/generations/tasks

使用豆包官方原生 API 格式提交视频生成任务（异步）。

与 /v1/video/generations 的区别：

使用豆包原生请求格式（content 在顶层）

参数名称和结构与豆包官方 API 完全一致

适合从豆包官方 API 迁移的用户

请求格式特点：

content 数组在顶层（而非 metadata 中）

prompt 可在顶层或作为 content 数组中的 text 类型

时长使用 duration 字段（整数类型，如 5 或 -1）

其他参数（ratio、resolution、watermark 等）在顶层

支持的生成场景：

文生视频：content 包含 text 类型

图生视频：content 包含 text + image_url 类型

视频续拍：content 包含 text + video_url 类型（自动应用6折计费）

多模态输入：content 可同时包含图片、视频、音频引用

提交成功后立即返回任务 ID，请使用 GET /api/v3/contents/generations/tasks/{task_id} 查询任务状态。

💡 格式提示：如需使用 OpenAI 兼容格式，请使用 POST /v1/video/generations 路由。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

or

Body 参数application/json必填

示例

文生视频 - 智能选择时长文生视频 - 指定 8 秒时长图生视频（含参考图片）视频续拍 - 基于已有视频片段续拍（约6折计费）多模态输入 - 图片+视频+音频引用（豆包官方实际案例）使用快速版模型（速度更快）

{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "宇航员在月球表面慢慢行走，地球悬挂在黑色天空中，画面宏大震撼"
        }
    ],
    "ratio": "16:9",
    "resolution": "720p",
    "duration": -1
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURL

文生视频 - 智能选择时长文生视频 - 指定 8 秒时长图生视频（含参考图片）视频续拍 - 基于已有视频片段续拍（约6折计费）多模态输入 - 图片+视频+音频引用（豆包官方实际案例）使用快速版模型（速度更快）

curl --location --request POST '/api/v3/contents/generations/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "宇航员在月球表面慢慢行走，地球悬挂在黑色天空中，画面宏大震撼"
        }
    ],
    "ratio": "16:9",
    "resolution": "720p",
    "duration": -1
}'

返回响应

🟢200

application/json

任务提交成功（此时任务仍在排队，status 为 pending）

Body

示例

{
    "id": "task_abc123def456",
    "model": "doubao-seedance-2-0-260128",
    "status": "pending",
    "created_at": 1712345678
}

🟠400

🟠401

🟠403

修改于 2026-04-30 09:14:09

查询视频生成任务状态（豆包原生格式）