视频生成
SuperToken 的新版视频接口采用统一异步任务模式。提交 POST /v1/video/tasks 后，平台返回任务 ID；你可以使用资源 API Key 轮询状态，也可以通过账号级 Webhook 接收成功或失败通知。
接入流程
- 提交视频任务，接口返回任务 ID。
- 使用任务 ID 查询状态，直到任务变为完成或失败。
- 任务完成后，从
result.videos[]获取视频地址，并根据url_auth决定是否携带资源 API Key。 - 在控制台的任务日志里查看历史记录、生成耗时、进度和结果。
支持的模型族
| 模型族 | 文档 | 说明 |
|---|---|---|
| Seedance | Seedance 异步视频 API | 支持 2.0 / Fast 与 2.5；2.5 提供 480p/720p、4–30 秒、首尾帧和多媒体参考 |
| Kling 3.0 | Kling 3.0 异步视频 API | Kling 3.0 支持纯文本和可选首帧/尾帧；Kling 3.0 Omni 额外支持最多三图参考 |
| Veo 3.1 | Veo 3.1 异步视频 API | Standard 支持帧或三图参考；Fast 使用帧模式 |
| MiniMax H3 | MiniMax H3 异步视频 API | 固定 1440p，支持 6 种画幅、文生视频、首尾帧、普通参考图和图片加音频参考 |
| xAI | xAI 视频生成 | 支持 Grok Imagine 纯文生视频、图生视频、参考图视频和 1.5 Preview 图生视频规格 |
统一接口
| 能力 | 方法与路径 | 密钥 |
|---|---|---|
| 创建任务 | POST /v1/video/tasks | 模型 API Token，sk-... |
| 查询任务 | GET /v1/video/tasks/{task_id} | 资源 API Key，ak_... |
| 列出任务 | GET /v1/video/tasks | 资源 API Key，ak_... |
| 批量查询 | POST /v1/video/tasks/query | 资源 API Key，ak_... |
| 完成通知 | 账号级 Webhook | 接收端校验 Webhook Key，wk-... |
不同模型的时长、画幅和参考素材限制并不相同。调用前先查看对应模型页，并以 GET /v1/models 返回的当前可用模型为准。
生成音轨参数已统一
新版接口只接受 output.generate_audio。旧的 provider_options.*.generate_audio 和 provider_options.*.reference_mode 已停止兼容，分别改用 output.generate_audio 和 input.reference_mode。
分辨率由模型决定
带 720p 或 1080p 的模型是独立规格。不要传 output.resolution 尝试改变分辨率；不支持的组合会在扣费和上游提交前返回 400。
任务日志
视频任务会出现在平台的任务日志中。任务列表会展示提交时间、结束时间、花费时间、平台、类型、任务 ID、任务状态、进度和结果操作。
任务完成后，结果列会显示视频相关操作入口，可用于预览或打开视频。API 调用和控制台记录使用同一个任务 ID，便于排查生成过程和保存历史结果。