提交视频生成任务（OpenAI 兼容格式）

POST

/v1/video/generations

向豆包 Seedance 2.0 视频模型提交一个视频生成任务（异步）。

提交成功后立即返回任务 ID，视频不会即时生成完毕。

请使用返回的 id 轮询 GET /v1/video/generations/{task_id} 查询任务状态。

请求格式：使用 new-api 内部格式（OpenAI 兼容）

扩展参数需放在 metadata 对象中

时长使用 seconds 字段（字符串类型）

支持的生成场景：

场景	所需字段
文生视频	`model` + `prompt`
图生视频	`model` + `prompt` + `image`（图片URL）
视频续拍	`model` + `prompt` + `metadata.content`（含 `video_url`）

⚠️ 计费提示：视频时长影响费用，seconds="-1" 时由模型自动选择，实际时长可通过查询 API 的 duration 字段获取。

💡 格式提示：如需使用豆包原生格式，请使用 POST /api/v3/contents/generations/tasks 路由。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

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

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

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

返回响应

🟢200

application/json

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

Body

示例

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

🟠400

🟠401

🟠402

🔴500

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

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

查询视频生成任务状态