Seedance 2.0 视频生成 API 快速上手

Seedance 2.0 是当前文生视频里性价比相当突出的一档:动作连贯、镜头语言自然,价格却只有头部模型的零头。我们已在网关上完整接入,这篇给出从提交任务到拿到成片的最短路径。

视频生成是异步任务

与聊天补全不同,视频生成走「提交任务 → 轮询状态 → 下载成片」的异步流程:

# 1. 提交生成任务
curl https://api.hop-base.com/v1/video/generations \
  -H "Authorization: Bearer 你的Key" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "清晨的海边栈道,镜头缓慢前推,海鸥掠过",
    "duration": 5,
    "resolution": "1080p"
  }'

# 2. 用返回的 task_id 轮询状态,完成后拿到视频 URL

生成通常需要一到几分钟,轮询间隔建议 5~10 秒。

参数与计费的对应关系

时长与分辨率决定价格:计费按「时长 × 分辨率档位」分桶,5 秒 720p 是试手感的最便宜组合,确认效果再上 1080p。
提示词写「镜头」而不是「故事」:一段 5~10 秒的视频只装得下一个镜头。「缓慢前推」「逆光剪影」「固定机位」这类摄影语言,比复述剧情有效得多。
图生视频:传入首帧图片可以让画面风格完全可控,适合品牌素材的批量生产。

成片链接 24 小时有效,请及时转存

上游返回的视频 URL 带有 24 小时时效签名,过期后不可再取。拿到成片后第一时间下载转存到自己的存储,不要把上游 URL 直接嵌进业务页面。

适合它的场景

短视频素材、商品展示动效、社媒广告的 A/B 素材批量生产——这类「量大、单条成本敏感、允许挑片」的场景,Seedance 的性价比优势最明显。先小额充值跑十条,挑出可用率,再决定量产规模,是最稳妥的启动方式。