创建视频任务

提交一个视频生成任务，立即拿到任务 ID。

最后更新：2026-10-13

视频生成耗时通常在数十秒到数分钟之间，接口采用「异步任务」模式：提交后立刻返回任务对象，你拿着 id 去轮询结果。

curl https://yqzktech.com/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-720p-5s",
    "prompt": "清晨的南方水乡，鸟船从石桥下缓缓驶出",
    "seconds": 5,
    "metadata": {"resolution": "720p", "ratio": "16:9"}
  }'

{
  "id": "video_01a2b3c4d5e6",
  "object": "video",
  "status": "queued",
  "progress": 0,
  "created_at": 1760000000,
  "model": "seedance-720p-5s"
}

请求参数说明：

参数	类型	必填	说明
`model`	string	是	规格化模型名，如 seedance-720p-5s
`prompt`	string	是	画面描述文案，中文效果更佳
`seconds`	int	否	时长，需与所选模型规格一致
`metadata.resolution`	string	否	分辨率，如 720p
`metadata.ratio`	string	否	宽高比，如 16:9 / 1:1 / 9:16

注意：规格必须落在已上架的模型名上。我们按「分辨率 × 时长」把视频拆成独立模型计价，混用规格会导致请求被拒绝。