---
title: 视频生成
description: 使用视频分组创建异步任务，示例采用 Wan 3.0 的时长与分辨率参数。
api: "POST /v1/videos"
---

按模型查看完整参数与多语言示例：[H3](/models/h3/generation)、[WAN 3.0](/models/wan3/generation)、[Grok 视频](/models/grok/generation)。

<RequestExample>
```bash Wan 3.0
curl https://sub.vcnovb.cn/v1/videos \
  -H "Authorization: Bearer $VC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video","prompt":"小猫在月光下的屋顶奔跑，平滑跟拍，细腻光影","seconds":"5","size":"720P","aspect_ratio":"16:9"}'
```
```python Python · 标准库
import json
import os
from urllib.request import Request, urlopen

payload = {
    "model": "wan3.0-video",
    "prompt": "小猫在月光下的屋顶奔跑，平滑跟拍，细腻光影",
    "seconds": "5",
    "size": "720P",
    "aspect_ratio": "16:9",
}
request = Request(
    "https://sub.vcnovb.cn/v1/videos",
    data=json.dumps(payload).encode("utf-8"),
    headers={"Authorization": "Bearer " + os.environ["VC_API_KEY"],
             "Content-Type": "application/json"},
    method="POST",
)
with urlopen(request, timeout=120) as response:
    print(json.load(response))
```
</RequestExample>

## Wan 3.0 参数

<ParamField body="model" type="string" required>填写 `wan3.0-video` 或 `wan3.0-video-prime`，并选择包含该模型的分组。</ParamField>
<ParamField body="prompt" type="string" required>描述主体、动作、镜头、光影与风格。</ParamField>
<ParamField body="seconds" type="integer | string">Wan 3.0 支持 2–30 秒整数或整数字符串，默认 5 秒。示例使用字符串。</ParamField>
<ParamField body="size" type="string">Wan 3.0 支持 `480P`、`720P`、`1080P`，默认 `1080P`。</ParamField>
<ParamField body="aspect_ratio" type="string">画面比例，例如 16:9；可选值由模型能力决定。</ParamField>

## 其他视频模型

| 模型 | 参数文档 |
| --- | --- |
| MiniMax H3 | [H3 视频生成](/models/h3/generation) |
| WAN 3.0 / Prime | [WAN 3.0 视频生成](/models/wan3/generation) |
| Grok 1.5 Preview | [Grok 视频生成](/models/grok/generation) |

各模型的参考图、时长和分辨率参数见对应页面。

## 提交之后

视频采用异步生成。保存返回的任务 ID，通过[查询接口](/api/video-tasks)获取进度和结果，完成后下载视频。

视频按分组的秒数或次数规则计费，费用可在[使用记录](/guides/usage)查看。查询超时后继续查询原任务。