> ## 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-Highspeed — 文生视频

> 使用 MiniMax-H3-Highspeed 根据文本提示词生成 4–15 秒带同步音频的视频。

| | |
| - | - |
| **模型 ID** | `minimax/minimax-h3-highspeed-t2v` |
| **系列** | `minimax-h3-highspeed` |
| **任务** | `text-to-video` |
| **模态** | 视频 |
| **上游** | MiniMax-H3-Highspeed（MiniMax 官方 API） |

> [!NOTE]
>
> H3-Highspeed 生成的视频包含同步音频，时长 4–15 秒，分辨率 768P。文生视频
> 必须显式指定宽高比 —— 不接受 `adaptive`。

## 端点

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

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

## 参数

**prompt** `string` *required*

描述目标视频的文本提示词。最长 7000 字符。

**duration** `"4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15"` (default: "6")

生成视频的时长（秒）。与分辨率共同决定价格。

**resolution** `"768P"` (default: "768P")

输出分辨率。H3-Highspeed 仅支持 768P。

**aspect\_ratio** `"16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9"` (default: "16:9")

宽高比。文生视频必须显式指定 —— 该任务不接受 `adaptive`。

## 控制音频

没有独立的音频参数——指挥画面的 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-highspeed-t2v",
    "prompt": "夜市小吃街，人群热闹，电影感镜头",
    "duration": "6",
    "resolution": "768P",
    "aspect_ratio": "16:9"
  }'
```

```json theme={null}
{ "id": "task_abc123…", "status": "pending", "model": "minimax/minimax-h3-highspeed-t2v" }
```

轮询直到终态：

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations/task_abc123… \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY"
```

```json theme={null}
{
  "id": "task_abc123…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.