# MiniMax H3 请求参数

接口与其他视频模型相同：

- 国内站创建：`POST https://api.xrtoken.net/v1/videos/generations`
- 国际站创建：`POST https://api.xrtoken.ai/v1/videos/generations`
- 查询：`GET {同一 host}/v1/videos/generations/{id}`

国内站和国际站均提供 `MiniMax-H3`。计费按生成秒。参考图前 5 张免费，超出另计；请求里带参考视频时，输入视频秒数按同档秒价计。国内站按 MiniMax 国内官方刊例；国际站按美元官方刊例。

| 站点 | 768P | 2K | 超出参考图 |
|---|---|---|---|
| 国内站 | ¥0.50 / 秒 | ¥0.80 / 秒 | ¥0.20 / 张 |
| 国际站 | $0.08 / 秒 | $0.13 / 秒 | $0.04 / 张 |

## 参数标准

| 字段 | 必填 | 取值 |
|---|---|---|
| `model` | 是 | `MiniMax-H3` |
| `content` | 是 | 数组。必须包含一项非空的 `{ "type": "text", "text": "..." }` |
| `duration` | 是 | 整数 `4`–`15` |
| `resolution` | 是 | `768P` 或 `2K` |
| `ratio` | 文生必填 | `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9` 之一 |

`content` 里除文本外，图 / 视频 / 音频必须用下面的 `type` + `role`：

| type | role | 用途 |
|---|---|---|
| `image_url` | `first_frame` | 首帧（图生） |
| `image_url` | `last_frame` | 尾帧（图生） |
| `image_url` | `reference_image` | 参考图 |
| `video_url` | `reference_video` | 参考视频 |
| `audio_url` | `reference_audio` | 参考音频 |

规则：

- 媒体 URL 用公网 `https`。本模型不使用 `asset://`。
- 图 + 视频 + 音频合计最多 12 个。
- **文生**、**首尾帧图生**、**参考生** 三选一。`first_frame` / `last_frame` 不得与任何 `reference_*` 同时出现。
- `duration` 必须是整数，不能是 `-1`，不能带小数。
- `resolution` 只接受 `768P`、`2K`，大小写按表内写法。
- 文生不要用 `adaptive` 作为 `ratio`。

本模型不支持：`generate_audio`、`camera_fixed`、`watermark`、`fps`、`seed`、`service_tier`。

## 示例

### 文生视频

```bash
curl -sS https://api.xrtoken.net/v1/videos/generations \
  -H "Authorization: Bearer $XRT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      { "type": "text", "text": "一只橘猫在阳光草地里慢镜头奔跑，电影质感" }
    ],
    "duration": 5,
    "resolution": "2K",
    "ratio": "16:9"
  }'
```

### 图生视频（首帧）

```json
{
  "model": "MiniMax-H3",
  "content": [
    { "type": "text", "text": "苹果在阳光下轻轻滚动" },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/apple.jpg" },
      "role": "first_frame"
    }
  ],
  "duration": 6,
  "resolution": "768P",
  "ratio": "16:9"
}
```

首尾帧再加一条 `"role": "last_frame"` 的图片。

### 参考生视频

```json
{
  "model": "MiniMax-H3",
  "content": [
    { "type": "text", "text": "全程用参考视频的运镜，用参考音频当 BGM" },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/style.jpg" },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": { "url": "https://example.com/cam.mp4" },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": { "url": "https://example.com/bgm.mp3" },
      "role": "reference_audio"
    }
  ],
  "duration": 8,
  "resolution": "2K",
  "ratio": "16:9"
}
```

## 查询

创建成功返回任务 `id`。轮询：

```bash
curl -sS "https://api.xrtoken.net/v1/videos/generations/$TASK_ID" \
  -H "Authorization: Bearer $XRT_API_KEY"
```

状态为 `queued` / `processing` / `succeeded` / `failed`。成功后成片地址在 `content.video_url`。

完整字段表见 [创建视频生成任务](/docs/api/createVideoGeneration)。