创建视频任务

POST

https://www.xinglianapi.com/v1/videos

Seedance 系列创建视频任务（站内 v1 统一接口）。

· 任务类型由 images 数量决定：不传 → 文生视频，1 张 → 首帧生视频，2 张 → 首尾帧生视频
· 提交时按约 25 万 token 预扣，余额不足会直接拒绝，任务不会发出；任务失败时预扣全额退回
· 视频链接 24 小时内有效，请及时转存

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

文生视频首帧生视频首尾帧生视频

{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "一只橘猫在窗台上伸懒腰，阳光洒进来",
    "size": "720p",
    "duration": 5,
    "metadata": {
        "ratio": "16:9",
        "watermark": false,
        "seed": 42
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生视频首帧生视频首尾帧生视频

curl --location 'https://www.xinglianapi.com/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "一只橘猫在窗台上伸懒腰，阳光洒进来",
    "size": "720p",
    "duration": 5,
    "metadata": {
        "ratio": "16:9",
        "watermark": false,
        "seed": 42
    }
}'

返回响应

🟢200

application/json

任务创建成功

Bodyapplication/json

示例

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

🟠400

🟠401

🟠403

🟠429

修改于 2026-10-14 10:12:50

计费说明

查询任务状态