# 视频任务

视频生成通常采用异步任务。提交请求后先取得任务 ID，再查询进度，最后获取生成结果。

## 提交与查询

以下路径适用于支持 OpenAI 兼容视频协议的通道；Veo、Kling 等型号可能使用不同协议，以实际模型与通道配置为准。

| 步骤 | 路径 | 需要保存的信息 |
| --- | --- | --- |
| 创建任务 | `POST /v1/videos` | 返回的任务 ID |
| 查询任务 | `GET /v1/videos/{video_id}` | 状态、进度与错误信息 |
| 获取结果 | `GET /v1/videos/{video_id}/content` | 生成的视频文件 |

## 处理任务状态

1. **已提交／排队中**：保存任务 ID，稍后查询。
2. **处理中**：继续等待，按服务建议的间隔查询。
3. **已完成**：读取结果或下载文件。
4. **失败**：查看错误信息，再决定是否重新提交。

相同任务尚未完成时，先查询状态再决定是否重新创建。时长、尺寸、参考图片和生成费用均与具体型号相关。

> 本文是视频协议与任务处理参考，不承诺当前有可调用的视频型号。请以服务端目录、密钥权限与可用额度为准；未配置通道时不能创建任务。模型状态页中的「暂无样本」表示没有监控样本，不代表任务失败。