# 通用视频任务接口

`POST /v1/video/generations`

通用视频生成任务接口，创建文生视频、图生视频和带扩展参数的视频任务。

## 请求格式
使用 `application/json`。必须包含 `model` 和 `prompt`。图生视频使用 `image` 或 `images`，具体字段以模型说明为准。

## 参数要点
- `duration`：生成时长，常见为 5、10 等数字。
- `size` / `aspect_ratio`：分辨率或画面比例。
- `mode`：模型模式，例如 std、pro。
- `metadata`：模型特有参数，例如镜头控制、负向提示词、运动强度、背景音乐等。

## 执行顺序
1. 调用本接口提交任务。
2. 保存返回的任务 ID。
3. 用 `GET /v1/video/generations/{task_id}` 查询状态。
4. 完成后读取结果 URL，或按返回结构下载文件。

## 错误定位
1. 一直处理中：拉长轮询间隔，并设置超时提示。
2. 参数不生效：确认参数应放在顶层还是 `metadata`。
3. 图生视频失败：确认参考图 URL 可访问，或文件字段是否按模型要求上传。

Tags: 视频任务