创建视频任务

POST

/v1/video/generations

统一创建入口。虽然上游文档常把文生视频、首帧生视频、首尾帧生视频、多模态参考生成分开展示，当前代理程序仍统一使用这一条接口收口。

当前最常见的 4 类请求示范已在下方提供：

文生视频：只传 prompt + 可选 metadata

首帧生视频：使用顶层 image

首尾帧生视频：使用 metadata.first_frame_image + metadata.last_frame_image

参考图生成：使用 metadata.reference_images，必要时可继续叠加 reference_videos / reference_audios

关键约束：

model 与 prompt 必填

顶层 image、首尾帧、reference_* 三类场景互斥

first_frame_image 与 last_frame_image 必须成对出现

metadata 可以省略；顶层 duration 会被归一化到 metadata.duration

成功响应只返回代理任务 id 与 proxy_meta，不直接返回上游任务结果

素材值既可以是公网 URL，也可以是已登记共享素材的 asset://<asset_id>。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

示例 1示例 2示例 3示例 4

文生视频：只用提示词生成视频，适合纯文案直生。示范了顶层 duration 兼容别名。

{
    "model": "seed-2-fast",
    "prompt": "清晨阳光穿过落地窗，一杯果茶放在木桌上，镜头缓慢推进，冷凝水顺着杯壁滑落，广告级产品特写。",
    "duration": 5,
    "metadata": {
        "ratio": "16:9",
        "resolution": "720p",
        "generate_audio": true,
        "watermark": false
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

示例 1示例 2示例 3示例 4

curl --location --request POST 'https://api.seedance.show/v1/video/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "seed-2-fast",
    "prompt": "清晨阳光穿过落地窗，一杯果茶放在木桌上，镜头缓慢推进，冷凝水顺着杯壁滑落，广告级产品特写。",
    "duration": 5,
    "metadata": {
        "ratio": "16:9",
        "resolution": "720p",
        "generate_audio": true,
        "watermark": false
    }
}'

返回响应

🟢202

application/json

任务已 accepted；返回代理任务 id 和代理侧冻结/队列信息，不直接返回上游视频结果

Body

示例

🟠400

🟠401

🟠402

🟠409

🟠429

🔴502

修改于 2026-04-13 02:51:41

查询任务