视频生成 Videos

视频生成为异步任务模式：先创建任务拿到任务 ID，再轮询查询结果。所有视频模型共用同一套 POST /v1/videos 接口，只需更换 model 参数。

支持的模型

模型系列	说明	详细文档
Seedance_sup	字节跳动视频生成模型，支持 720p / 1080p / 4K，配套 /v1/assets 素材库	Seedance_sup 使用说明 · 素材库
Seedance V3（原生）	火山原生协议 /v3/video/tasks，配套 /v3/assets 素材库	Seedance V3 使用说明 · 素材库 V3
Kling 可灵	快手视频生成模型	Kling 使用说明
Vidu 视频	生数科技 Vidu Q3 系列（viduq3-pro / viduq3-turbo），1–16 秒，默认音画同出	Vidu 使用说明
Grok Imagine	xAI grok-imagine-video 系列，1–15 秒（默认 8 秒），1.5 版支持原生音频与 1080p	Grok Imagine 使用说明

接口总览

操作	方法与路径	适用
创建视频任务（统一接口）	POST $URL/v1/videos	Seedance_sup / Kling
查询任务状态	GET $URL/v1/videos/{task_id}	Seedance_sup / Kling
创建任务（原生原厂）	POST $URL/v3/video/tasks	Seedance V3（原生）
查询/取消任务（原生原厂）	GET / DELETE $URL/v3/video/tasks/{task_id}	Seedance V3（原生）
素材库（Seedance_sup）	POST/GET $URL/v1/assets*	Seedance_sup
素材库（原生 V3）	POST/GET $URL/v3/assets*	Seedance V3（原生）

两套接口风格

• 统一接口 /v1/videos：所有模型通用，响应为 OpenAI Video 风格（id / status / video_url）——本文所述；
• 原厂透传：原生 Seedance V3 走火山原厂协议 /v3/video/tasks，素材库 /v3/assets*，见素材库 V3。

1. 创建任务

curl $URL/v1/videos \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "一只戴着墨镜的猫走在霓虹灯街道上",
    "seconds": "5",
    "size": "720p"
  }'

返回：

{
  "id": "task_xxxxxxxx",
  "model": "seedance-2-0",
  "status": "in_progress",
  "created_at": 1785000000
}

2. 查询任务

用上一步返回的 id 轮询任务状态（建议每 5~10 秒一次）：

curl $URL/v1/videos/task_xxxxxxxx \
  -H "Authorization: Bearer $YOUR_API_KEY"

生成完成后返回：

{
  "id": "task_xxxxxxxx",
  "model": "seedance-2-0",
  "status": "completed",
  "video_url": "https://..."
}

任务状态说明

状态	含义	处理建议
queued	排队中	继续轮询
in_progress	生成中	继续轮询
completed	生成成功	从返回体获取视频地址，请尽快下载保存
failed	生成失败	查看 error.message

幂等提示

如果你在请求中携带自定义的 client_request_id（幂等键），请确保每个新任务使用全新的唯一值（如 UUID）。复用旧值会命中上游幂等缓存，直接返回历史任务的结果。

超时说明

• 任务超过 20 分钟未完成会自动置为失败，不会无限等待，请通过轮询获取最终状态。

新模型接入

我们会持续接入新的视频模型。新模型上线后会在本节新增对应的使用说明页，接口调用方式保持不变，仅 model 名称与个别参数不同。