Seedance 视频 API Python 接入示例

下载示例

下载 seedance-video.py（Python 3.9 或更新版本）。请先阅读代码，再在自己的服务端运行。

SHA-256：1d223b05f6c3b43ceee28b6d68992d8e5554f05110d464f8ac3e551ec04d6559

配置服务端密钥

在控制台创建本站 API 密钥，使用环境变量 WXKS_API_KEY。不要把真实密钥写进网页、共享笔记、公开仓库或截图。

Linux / macOS shell：

export WXKS_API_KEY='你的本站密钥'

Windows PowerShell：

$env:WXKS_API_KEY='你的本站密钥'

提交一次 Seedance 2.5 特价2任务

此命令会创建付费任务：模型 seedance-2.5-special2，10 秒、1080P、16:9。当前公开计费为 ¥2.79/条；调用时以实时模型广场和账单为准。

python seedance-video.py submit --prompt "清晨竹林，镜头平稳向前推进" --seconds 10 --ratio 16:9

保存返回的本站任务 ID。示例不会自动重试提交；提交超时后先查控制台任务记录，不能认定任务未创建。

查询与等待已有任务

python seedance-video.py query 你的任务ID
python seedance-video.py wait 你的任务ID --minutes 20

wait 每隔至少 30 秒查询原任务，识别 queued、in_progress、completed、failed。20 分钟是客户端等待上限，不是服务端完成时间承诺；等待超时后继续保留原任务 ID。

下载已完成的视频

python seedance-video.py download 你的任务ID --output result.mp4

下载前检查任务已经 completed。示例不覆盖已有文件，跨域下载重定向时移除 Authorization 请求头，并拒绝降级到 HTTP。中断时保留 .part 文件，处理后再选择新的输出文件名。

使用前核对

• 这是接入示例，不是官方通用 SDK；按自己的业务实现任务持久化、监控和人工排查。
• 示例固定使用特价2型号；需要参考素材时查看素材接入指南。
• 不要把图片接口的同步结果套用为视频状态，也不要把旧接口的状态字段与 V1 混用。
• 下载的代码不包含密钥；运行示例不会授予任何超出你所用 API 密钥的权限。

资料来源

接口和状态依据当前统一 V1 文档；价格依据实时模型广场与公开计费配置。核对日期：2026-11-02。