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

# MiniMax-H3-Max — 图生视频

> 使用 MiniMax-H3-Max 将首帧图片扩展为 5–15 秒带音频视频。

|           |                                |
| --------- | ------------------------------ |
| **模型 ID** | `minimax/minimax-h3-max-i2v`   |
| **系列**    | `minimax-h3-max`               |
| **任务**    | `image-to-video`               |
| **模态**    | 视频                             |
| **上游**    | MiniMax-H3-Max（MiniMax 官方 API） |

## 端点

```http theme={null}
POST https://vibetoken.cn/v1/videos/generations
```

异步 —— 返回 `{id, status: "pending"}`；轮询
`GET /v1/videos/generations/{id}` 直到 `success` 或 `failed`。

## 参数

<ParamField body="prompt" type="string" required>
  描述首帧应如何动起来的文本提示词。最长 7000 字符。
</ParamField>

<ParamField body="image_urls" type="string[]" required>
  仅含一个元素的数组，为待动画化的首帧图片 URL。
</ParamField>

<ParamField body="duration" type="&#x22;5&#x22; | &#x22;6&#x22; | &#x22;7&#x22; | &#x22;8&#x22; | &#x22;9&#x22; | &#x22;10&#x22; | &#x22;11&#x22; | &#x22;12&#x22; | &#x22;13&#x22; | &#x22;14&#x22; | &#x22;15&#x22;" default="&#x22;6&#x22;">
  生成视频的时长（秒）。价格按输出秒数计。
</ParamField>

<ParamField body="resolution" type="&#x22;480P&#x22; | &#x22;768P&#x22;" default="&#x22;768P&#x22;">
  输出分辨率。480P 的每秒单价低于 768P。
</ParamField>

<ParamField body="aspect_ratio" type="&#x22;adaptive&#x22; | &#x22;16:9&#x22; | &#x22;4:3&#x22; | &#x22;1:1&#x22; | &#x22;3:4&#x22; | &#x22;9:16&#x22; | &#x22;21:9&#x22;" default="&#x22;adaptive&#x22;">
  宽高比。`adaptive` 跟随输入图片的比例。
</ParamField>

## 控制音频

没有独立的音频参数——指挥画面的 prompt 同时指挥声音。先描述画面，再用 `Sound:` 子句描述声轨：环境音、音效、配乐或台词。

```text theme={null}
雨夜的霓虹街道，镜头缓缓推向一座电话亭。
Sound: 雨伞上的细雨声，远处的雷声，低沉的合成器铺底。
```

想要安静的片段，就把声轨描述为安静（例如 `Sound: 房间底噪，微弱的钟表滴答声`）。音频与画面原生同步生成、已含在价格内——无法通过参数关闭。

## 示例

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-h3-max-i2v",
    "prompt": "人物转身微笑，镜头缓慢推近",
    "image_urls": ["https://example.com/frame.png"],
    "duration": "8",
    "resolution": "768P"
  }'
```