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

# MiniMax Hailuo H3 動画生成

> MiniMax Hailuo H3 でテキスト、先頭・末尾フレーム、マルチモーダル参照から 2K または 768p 動画を生成

> [!NOTE]
>
> **中国本土のユーザー向け：** 中国本土のユーザーは `https://toapis.cn` を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では `https://toapis.com` を `https://toapis.cn` に置き換えてください。

* `MiniMax-H3`、`MiniMax-H3-Max`、`MiniMax-H3-Max-Turbo` の3モデルに対応します
* `MiniMax-H3` と `MiniMax-H3-Max` はテキスト動画、先頭/末尾フレーム、画像・動画・音声の複合参照に対応します
* `MiniMax-H3-Max-Turbo` はテキスト動画と先頭/末尾フレームのみに対応し、参照素材には対応しません
* 旧 H3 は `2K` / `768p`、`4-15` 秒。Max / Max-Turbo は `480P` / `768P`、`5-15` 秒です
* 非同期 API は統一形式の `generation.task` を返します

> [!WARNING]
>
> `MiniMax-H3-Max-Turbo` は `reference_image`、`reference_video`、`reference_audio` に対応しません。参照素材を送信すると `MiniMax-H3-Max-Turbo does not support reference media` が返されます。参照動画を使う場合は `MiniMax-H3` または `MiniMax-H3-Max` を選択してください。

> [!WARNING]
>
> 公開アクセス可能な素材 URL を使用してください。先頭/末尾フレームモードと参照モードは併用できません。参照音声だけの入力もできません。

## 認証

**Authorization** `string` *required*

`Authorization: Bearer YOUR_API_KEY` を送信してください。

## リクエストパラメータ

**model** `string` *required* (default: MiniMax-H3)

`MiniMax-H3`、`MiniMax-H3-Max`、`MiniMax-H3-Max-Turbo` から選択します。マルチモーダル参照は `MiniMax-H3` と `MiniMax-H3-Max` のみが対応します。Turbo はテキスト動画と先頭/末尾フレームのみに対応します。

**prompt** `string` *required*

動画の説明。最大 `7000` 文字です。

**duration** `integer` (default: 5)

`MiniMax-H3` は `4-15` 秒、Max / Max-Turbo は `5-15` 秒の整数に対応します。

**resolution** `string` (default: 2K)

`MiniMax-H3` は `2K` と `768p`、Max / Max-Turbo は `480P` と `768P` に対応します。

**aspect\_ratio** `string` (default: 16:9)

`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`adaptive`。
テキスト動画では `adaptive` は使えません。フレームモードでは入力画像に自動適応し、参照モードは既定で `adaptive` です。
参照モードは `MiniMax-H3` と `MiniMax-H3-Max` のみが対応します。

**image\_urls** `string[]`

互換用画像 URL。1 枚は先頭、2 枚は先頭/末尾、3-9 枚は参照画像として扱われます。新規実装では `image_with_roles` を推奨します。
3-9 枚の参照画像入力は `MiniMax-H3` と `MiniMax-H3-Max` のみが対応し、Turbo では使用できません。

**image\_with\_roles** `array`

`url` と `role` を持つ画像配列。role は `first_frame`（最大 1）、`last_frame`（最大 1）、`reference_image`（最大 9）です。
`reference_image` は `MiniMax-H3` と `MiniMax-H3-Max` のみが対応します。Turbo では `first_frame` と `last_frame` のみ使用できます。
JPG、JPEG、PNG、WebP、HEIC、HEIF、最大 `30 MB`、各辺 `256-5760 px`、縦横比 `0.4-2.5` に対応します。

**video\_with\_roles** `array`

`MiniMax-H3` と `MiniMax-H3-Max` のみが対応し、Turbo では使用できません。
最大 `3` 本の参照動画。各項目は `url` と `role: reference_video` を持ちます。MP4/MOV、最大 `50 MB`、各 `2-15` 秒、合計 `15` 秒までです。
\[!NOTE] ToAPIs が実際の動画時間を読み取って課金します。クライアント計算の時間は送信しないでください。

**audio\_with\_roles** `array`

`MiniMax-H3` と `MiniMax-H3-Max` のみが対応し、Turbo では使用できません。
最大 `3` 本の参照音声。各項目は `url` と `role: reference_audio` を持ちます。WAV/MP3、最大 `15 MB`、各 `2-15` 秒、合計 `15` 秒までです。
\[!WARNING] 少なくとも 1 つの参照画像または参照動画が必要です。

**watermark** `boolean` (default: false)

AIGC ウォーターマークを追加するかどうか。

**client\_business\_id** `string`

注文 ID などのクライアント側業務 ID。

**callback\_url** `string`

ToAPIs タスク完了 Callback。[Webhook](https://docs.toapis.com/docs/ja/api-reference/webhooks/task-webhooks.md) を参照してください。

## モードと制限

| モード | 対応モデル | 入力 | 比率 |
| - | - | - | - |
| テキスト動画 | 全 3 モデル | `prompt` | 具体値、既定 `16:9` |
| 先頭/末尾フレーム | 全 3 モデル | `prompt` + フレーム画像 | 自動 `adaptive` |
| マルチモーダル参照 | `MiniMax-H3` と `MiniMax-H3-Max` のみ | `prompt` + 参照素材 | 既定 `adaptive` |

以下の参照素材の制限は `MiniMax-H3` と `MiniMax-H3-Max` にのみ適用されます。

参照素材は画像 9、動画 3、音声 3、合計 12 ファイルまでです。フレーム role と参照 role は混在できません。

## 例

参照素材の例は `MiniMax-H3` を使用しています。`model` を `MiniMax-H3-Max-Turbo` に置き換えるだけでは使用できません。`MiniMax-H3-Max` を使用する場合は、`resolution` を `480P` または `768P`、`duration` を `5-15` 秒に設定してください。

```json theme={null}
{
  "model": "MiniMax-H3",
  "prompt": "動画1の動きとカメラリズムを参照し、音声1の声で台詞を話す",
  "duration": 5,
  "resolution": "768p",
  "aspect_ratio": "adaptive",
  "video_with_roles": [
    {"url": "https://example.com/motion.mp4", "role": "reference_video"}
  ],
  "audio_with_roles": [
    {"url": "https://example.com/voice.mp3", "role": "reference_audio"}
  ]
}
```

## レスポンス

**id** `string`

ToAPIs タスク ID。

**object** `string`

`generation.task` 固定。

**model** `string`

`MiniMax-H3` 固定。

**status** `string`

`queued`、`in_progress`、`completed`、`failed`。

**progress** `integer`

`0-100` の進捗。

**created\_at** `integer`

Unix 作成時刻（秒）。

> [!NOTE]
>
> [動画タスク状態取得](https://docs.toapis.com/docs/ja/api-reference/tasks/video-status.md)をポーリングしてください。完了時の URL は `result.data[0].url` にあります。

```bash cURL（テキスト動画） theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"MiniMax-H3","prompt":"月面の宇宙飛行士をカメラがゆっくり捉える","duration":5,"resolution":"2K","aspect_ratio":"16:9"}'
```

```bash cURL（画像・動画・音声の複合参照） theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "画像1の人物を維持し、動画1の動きとカメラを参照し、音声1の声で台詞を話す",
    "duration": 5,
    "resolution": "2K",
    "aspect_ratio": "adaptive",
    "image_with_roles": [{"url": "https://example.com/person.png", "role": "reference_image"}],
    "video_with_roles": [{"url": "https://example.com/motion.mp4", "role": "reference_video"}],
    "audio_with_roles": [{"url": "https://example.com/voice.mp3", "role": "reference_audio"}]
  }'
```

```json 200 theme={null}
{"id":"vid_01KZ3H3EXAMPLE00000000000","object":"generation.task","model":"MiniMax-H3","status":"queued","progress":0,"created_at":1785729000}
```


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