> ## Documentation Index
> Fetch the complete documentation index at: https://doc.deepwl.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax-H3 创建视频（统一格式）

> 使用 `POST /v1/video/create` 以统一视频格式创建 MiniMax-H3 任务。

# MiniMax-H3 创建视频（统一格式）

统一视频格式入口。请求体字段、生成场景与文件限制与 [OpenAI 格式的视频生成](./generation) **完全一致**，区别仅在创建路径。

<Note>
  请求/响应字段的完整说明与输入文件限制请参考 [视频生成（OpenAI 格式）](./generation)。本页仅给出统一格式的入口与示例。
</Note>

## 方法与路径

```http theme={null}
POST /v1/video/create
```

<RequestExample>
  ```bash 文生视频 (t2va) theme={null}
  curl -X POST https://zx1.deepwl.net/v1/video/create \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "MiniMax-H3",
      "prompt": "一个男孩在海边打篮球",
      "duration": 5,
      "size": "2K",
      "metadata": {
        "ratio": "16:9"
      }
    }'
  ```

  ```bash 图生视频 (i2va) theme={null}
  curl -X POST https://zx1.deepwl.net/v1/video/create \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "MiniMax-H3",
      "prompt": "镜头缓缓推进，海浪拍打礁石溅起水花",
      "duration": 5,
      "size": "2K",
      "image": "https://cdn.example.com/first-frame.jpg",
      "metadata": {
        "ratio": "adaptive"
      }
    }'
  ```

  ```bash 多模态参考生视频 (r2va) theme={null}
  curl -X POST https://zx1.deepwl.net/v1/video/create \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "MiniMax-H3",
      "prompt": "沿用参考视频的运动节奏与参考音频的情绪重新生成",
      "duration": 5,
      "size": "2K",
      "metadata": {
        "ratio": "adaptive",
        "reference_video": "https://cdn.example.com/reference.mp4",
        "reference_audio": "https://cdn.example.com/bgm.wav"
      }
    }'
  ```
</RequestExample>

## 响应示例

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "task_a1b2xxxxx5f6",
    "task_id": "task_a1b2xxxxx5f6",
    "object": "video",
    "model": "MiniMax-H3",
    "status": "queued",
    "progress": 0,
    "created_at": 1785125529
  }
  ```

  ```json 400 theme={null}
  {
    "code": "invalid_request",
    "message": "prompt is required",
    "data": null
  }
  ```
</ResponseExample>

响应字段含义与 [视频生成（OpenAI 格式）](./generation) 一致。

## 错误码

| HTTP 状态码 | 说明       |
| -------- | -------- |
| `400`    | 请求参数错误   |
| `401`    | 鉴权失败     |
| `402`    | 额度不足     |
| `422`    | 输入涉及敏感内容 |
| `429`    | 触发限流     |
| `500`    | 服务端错误    |

## 相关接口

* [MiniMax-H3 视频概览](./overview)
* [视频生成（OpenAI 格式）](./generation)
* [2K 再生成（统一格式）](./unified-remix)
* [查询任务（统一格式）](./unified-query)