> ## 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 —— 参考图生视频

> 通过 MiniMax-H3，依据一张参考图像保持主体/角色一致，生成 2K 视频。

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

<Note>
  MiniMax-H3 参考图生视频接收一张主体/角色参考图像，并在生成的 2K 片段中
  保持该身份一致，由你的文本提示词驱动。与图生视频不同，参考图像不会被用作
  字面意义上的首帧。片段按输出秒数计价。
</Note>

## 端点

```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;6&#x22; | &#x22;10&#x22;" default="&#x22;6&#x22;">
  生成片段的时长（秒）。决定价格（按输出秒数计价）。
</ParamField>

<ParamField body="resolution" type="&#x22;2K&#x22;" default="&#x22;2K&#x22;">
  输出分辨率。
</ParamField>

<ParamField body="aspect_ratio" type="&#x22;16:9&#x22; | &#x22;4:3&#x22; | &#x22;1:1&#x22; | &#x22;3:4&#x22; | &#x22;9:16&#x22; | &#x22;21:9&#x22; | &#x22;adaptive&#x22;" default="&#x22;16:9&#x22;">
  生成视频的画面比例。默认具体值 `16:9`；同时也接受 `adaptive`。
</ParamField>

## 示例

```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-r2v",
    "prompt": "the same character walking through a neon-lit market at night",
    "image_urls": ["https://example.com/character-reference.png"],
    "duration": "6",
    "resolution": "2K",
    "ratio": "16:9"
  }'
```

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

轮询直到终态：

```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" }]
}
```