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

POST

https://api.example.com/v1/videos

与 POST /v1/video/generations 功能完全相同，为兼容 OpenAI Video API 格式而提供的别名路由。

⭐ 真人过白（subject_type=person）

在 metadata.content 数组的 image_url 类型条目中添加 "subject_type": "person"，即可触发真人过白功能。

⚠️ 注意：subject_type: person 时图片只支持 URL 格式，不支持 Base64，否则报错： > Only URL inputs are supported for image, video, and audio assets. Base64 encoding is not supported.

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

扩展参数需放在 metadata 对象中

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

请求和响应格式与 /v1/video/generations 完全一致。

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

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

⭐ 真人过白文生视频 - 智能选择时长图生视频（含参考图片）视频续拍 - 基于已有视频片段续拍多模态输入 - 图片+视频+音频引用（实际案例）

{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "一个女孩在时代广场上跳中国舞",
    "metadata": {
        "content": [
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://eos.forcepic.com/uploads/20260421/69e73e5ceef05.png"
                },
                "subject_type": "person",
                "role": "reference_image"
            }
        ],
        "generate_audio": true,
        "resolution": "720p",
        "ratio": "16:9",
        "duration": 15,
        "seed": -1,
        "watermark": false
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

⭐ 真人过白文生视频 - 智能选择时长图生视频（含参考图片）视频续拍 - 基于已有视频片段续拍多模态输入 - 图片+视频+音频引用（实际案例）

curl --location 'https://api.example.com/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "一个女孩在时代广场上跳中国舞",
    "metadata": {
        "content": [
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://eos.forcepic.com/uploads/20260421/69e73e5ceef05.png"
                },
                "subject_type": "person",
                "role": "reference_image"
            }
        ],
        "generate_audio": true,
        "resolution": "720p",
        "ratio": "16:9",
        "duration": 15,
        "seed": -1,
        "watermark": false
    }
}'

返回响应

🟢200

application/json

任务提交成功

Bodyapplication/json

示例

{
    "id": "task_abc123def456",
    "task_id": "task_abc123def456",
    "object": "video",
    "model": "doubao-seedance-2-0-260128",
    "status": "queued",
    "progress": 100,
    "created_at": 1712345678,
    "completed_at": 1712345900,
    "expires_at": 1712432300,
    "metadata": {
        "url": "https://cdn.volcengineapi.com/videos/output-abc123.mp4"
    },
    "error": {
        "code": "content_policy_violation",
        "message": "请求内容违反了内容安全策略，请修改 prompt 后重试"
    },
    "remixed_from_video_id": "task_origin789ghi012"
}

🟠400

🟠401

修改于 2026-05-19 09:04:28

查询视频生成任务状态

查询任务状态（OpenAI 兼容格式）

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

⭐ 真人过白（subject_type=person）#

请求参数

请求示例代码

返回响应

⭐ 真人过白（subject_type=person）