# 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 / 张 |

## MiniMax H3 Max / Max-Turbo（国内站和国际站）

模型 ID 为 `MiniMax-H3-Max`、`MiniMax-H3-Max-Turbo`。两款均支持文生、首帧和首尾帧；Max 额外支持图片、视频、音频多模态参考，Turbo 不支持参考素材。

| 输出模型 / 分辨率 | 国内站 / 秒 | 国际站 / 秒 |
| --- | --- | --- |
| Max 480P | ¥0.33 | $0.05 |
| Max 768P | ¥0.50 | $0.08 |
| Max-Turbo 480P | ¥0.17 | $0.025 |
| Max-Turbo 768P | ¥0.26 | $0.04 |

Max 附加费用：参考视频按 **480P ¥0.37 / $0.0553 每秒**、**768P ¥0.97 / $0.143 每秒**计费；参考图片前 2 张免费，从第 3 张起 **¥0.50 / $0.074 每张**。音频参考不单独收费。Turbo 仅收输出费用。

Max 总费用 = 输出秒数 × 输出单价 + 输入视频秒数 × 参考视频单价 + max(图片数 − 2, 0) × 图片单价。输入视频以服务返回的 `input_seconds` 为准，不能把 `total_seconds` 直接乘输出单价。

参数规则（以下规则专用于 Max / Max-Turbo）：

- `duration` 为 **5–15 的整数秒**；`resolution` 为 **480P / 768P**。本接口省略时默认 5 秒、768P。
- `content` 必须有且仅有一项非空 `text`。媒体使用 `{ "type": "image_url", "role": "first_frame", "image_url": { "url": "..." } }` 的对象格式。
- 最多一张首帧、一张尾帧，尾帧必须配首帧。首尾帧不能与参考素材混用。
- Max 参考上限：9 张图、3 段视频、3 段音频，合计 12 个；仅音频参考不支持。每段视频/音频 2–15 秒；视频总时长、音频总时长分别不超过 15 秒，上游下载后校验。
- 文生使用具体 `ratio`；首帧/首尾帧建议 `adaptive`，Max 参考也支持 `adaptive`。
- 可传 `extra: { "prompt_expansion_mode": "disabled" | "balanced" | "quality" }`，默认 `balanced`；可传整数 `seed`。
- 创建、查询仍使用本页顶部的 XRToken 接口，`callback_url` 使用 XRToken 的回调机制。

示例：Max 768P 输出 5 秒 + 3 张图 + 10 秒参考视频 + 10 秒参考音频，国内 ¥12.70，国际 $1.904。

## 参数标准

| 字段 | 必填 | 取值 |
|---|---|---|
| `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.ai/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.ai/v1/videos/generations/$TASK_ID" \
  -H "Authorization: Bearer $XRT_API_KEY"
```

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

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