---
title: H3 视频生成
description: MiniMax-H3 视频生成的请求参数、调用示例与任务查询。
api: "POST /v1/videos"
---

使用绑定 H3 分组的 API Key。模型 ID 为 **`MiniMax-H3`**，提交结果为异步任务。

<RequestExample>
```bash cURL
curl https://sub.vcnovb.cn/v1/videos \
  -H "Authorization: Bearer $VC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "海边日落，镜头缓缓推向浪花，电影质感",
    "seconds": "8",
    "aspect_ratio": "16:9"
  }'
```
```python Python
import os
import requests

response = requests.post(
    "https://sub.vcnovb.cn/v1/videos",
    headers={"Authorization": f"Bearer {os.environ['VC_API_KEY']}"},
    json={
        "model": "MiniMax-H3",
        "prompt": "海边日落，镜头缓缓推向浪花，电影质感",
        "seconds": "8",
        "aspect_ratio": "16:9",
    },
    timeout=120,
)
response.raise_for_status()
print(response.json())
```
```javascript JavaScript
const response = await fetch("https://sub.vcnovb.cn/v1/videos", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VC_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "MiniMax-H3",
    prompt: "海边日落，镜头缓缓推向浪花，电影质感",
    seconds: "8",
    aspect_ratio: "16:9",
  }),
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
```
</RequestExample>

<ResponseExample>
```json 创建成功
{"id":"video_example_h3","status":"queued"}
```
```json 权限错误
{"error":{"type":"permission_error","message":"Video generation is not enabled for this group"}}
```
</ResponseExample>

## 请求参数

<ParamField body="model" type="string" required>填写 `MiniMax-H3`，区分大小写并确认 Key 的模型目录中存在该名称。</ParamField>
<ParamField body="prompt" type="string" required>视频描述，建议写清主体、动作、场景、镜头和风格。</ParamField>
<ParamField body="seconds" type="string | integer">目标视频时长，单位为秒。示例使用 `8`。</ParamField>
<ParamField body="aspect_ratio" type="string">画面宽高比，示例使用 `16:9`。</ParamField>

## 查询生成结果

保存创建响应的任务 ID，进入[H3 查询与下载](/models/h3/query)查看进度，完成后下载视频。