视频生成接入指引：从提交任务到拿到成片

指南#视频生成#接入#视频2 分钟阅读

视频生成和文本调用有个本质区别：它不可能是「一问一答」的同步接口——一段几秒钟的视频，生成往往要以分钟计。所以网关上的视频模型走异步任务链路，计费也换成了一把新尺子：按实际生成时长（秒）计费。

平台在营的视频模型

模型 定位
seedance-2.5 旗舰档，细节与画面表现力最强
seedance-2.0 综合能力强，适合对画质与运镜要求高的场景
seedance-2.0-fast 速度优先，适合批量生成与快速迭代
seedance-2.0-mini 成本最低的轻量档

以上仅为速览，各模型的支持能力与实时单价以模型广场标注为准。

提交任务

curl https://api.topsdyne.com/v1/videos \
  -H "Authorization: Bearer $TOPSDYNE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "清晨的城市天台，镜头缓缓推向一位眺望远方的少年，电影感光影"
  }'

提交成功后返回任务标识。是否支持图生视频、时长与分辨率档位因模型而异，提交前在模型详情页确认。

轮询与取片

凭任务标识轮询任务状态，任务完成后取回视频地址下载即可。生成是排队 + 推理的过程，等待时间随模型与档位不同，建议客户端用轮询间隔兜底而不是长连接死等——具体字段以文档站接口说明为准。

计费口径

视频模型按实际生成时长（秒）计费，各模型秒单价见模型广场。两个实操建议：

  1. 先短后长：新场景先用最短的时长档试跑，确认效果再上长时长，避免调试期白烧秒数；
  2. 提示词写结构：主体、场景、运镜、风格四要素写清楚，一次出片率远高于「想到什么写什么」。

相关模型