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

# ComfyUI MiniMax H3 プロンプトガイド: 公式ガイド、ヒント、プロンプト埋め込み

> ComfyUI でより良い MiniMax H3 プロンプトを書く方法: MiniMax の公式プロンプト作成ガイド、一般的なプロンプトのコツ、セリフと話者のルール、スタイル埋め込み。

H3 は 1 つのマルチモーダルプロンプトにショット、カメラ、台詞、SFX を載せます。このページは公式ガイド、ワークフロー横断のヒント、ショット/台詞ルール、スタイル埋め込みをまとめます。

## 公式ガイド

* [ベースモード](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md)（T2VA、I2VA、FL2VA、L2VA）: 時間軸ショット、カメラ、オーディオ
* [フルリファレンスモード](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md)（R2V）: リライト構造、参照ラベル、保持マーカー

インストール可能な [H3 skills](https://github.com/MiniMax-AI/MiniMax-H3/tree/main/skills) がエージェント向けにパッケージ化しています。

テンプレート別: [T2V/I2V](https://docs.comfy.org/ja/tutorials/video/minimax/minimax-h3-native.md)、[R2V](https://docs.comfy.org/ja/tutorials/video/minimax/minimax-h3-native.md#minimax-h3-リファレンスからビデオ-r2v)、[マルチフレーム](https://docs.comfy.org/ja/tutorials/video/minimax/minimax-h3-multiframe.md#プロンプト作成ガイド)、[Fun ControlNet](https://docs.comfy.org/ja/tutorials/video/minimax/minimax-h3-fun-controlnet.md#プロンプトのヒント)。

## 一般的なヒント

I2VA は固定の画像位置合わせ行で始まり、空行を挟んで本文フィールドが続きます。FL2VA/L2VA はそれぞれ独自の位置合わせ行を使用し、T2VA はフィールドから直接始まります:

```text theme={null}
integrated_multimodal_description: [Shot 1] ...
overall_soundscape: ...
non_diegetic_music: ...
```

プロンプトは**英語**で記述します。台詞/歌詞は `<d>` タグ内に、画面に表示する文字は元の言語のまま逐語的に記述します。

1. **シーンを先に**: まず全体のシーンを書き、次に `integrated_multimodal_description` の `[Shot 1]` 内に時間指定付きのショットを書く
2. **1 つのブロック**: ショット、カメラ、オーディオをまとめて記述する
3. **解像度**: 16:9 でネイティブ **1344×768**、**32** の倍数
4. **長さ**: `length` は 24fps のフレーム数（既定 **124** ≈ 5s）で、**17k+5** にスナップされる
5. **画面文字**: 各文字列を英語の二重引用符で囲み、原文のまま記述する（例: `A red neon sign reading "营业中"`）。話される台詞には `<d>` を使用し、引用符は使わない
6. **R2V オーディオマーカー**: 保持分析では、クリップの使われ方に合わせて各オーディオ参照を `fully_copy`、`partially_copy`、`reference`、`weak_reference` のいずれかでマークする（公式の ref ガイドの表を参照）
7. **オーディオフィールド**: `overall_soundscape` = 環境音/SFX/非言語音（1〜4 文。`N/A` は本当に無音の場合のみ）。台詞とダイジェティック音楽はショット内に残す。`non_diegetic_music` = スコアのみ（1〜3 文。なければ `N/A`）。不要な発話が現れる場合は、両方のフィールドを明示的に埋める
8. **ネガティブは使わない**: `BasicGuider` は `cfg` 1 で動作し、ネガティブ分岐はない。禁止リストは不要な概念を追加してしまう。表示すべき内容を記述する（または R2V の保持フィールド `fully_preserved`、`partially_preserved` などを使用する）
9. **参照シート（R2V）**: 1 枚の画像に複数のパネルを含めることができる。シート自体に専用の `<Picture N>` を付け（`<Subject N>` 内だけに書かない）、パネルを説明し、ショットからパネルを指定する（例: `<Picture 2>` の正面全身）。パネルには明確にラベルを付ける

ワークフロー固有のタグとコントロールは各ワークフローページにあります。

## ショットとカット

`[Shot 1]` は 0.00s から; 以降はカット時刻で開始:

```text theme={null}
[Shot 2] At 00:03.500, the camera cuts to...
```

* 時刻は増加し `length` 内
* 単一時刻（`At 00:05.000`）、範囲不可
* `the camera cuts to` など; 必要ならディゾルブ/フェード

被写体・空間・状態・視点・時間が変わるときに新ショット。微リフレームは 1 ショットでカメラモーション。

## セリフと話者

* **話者 ID**: `(S1)`、`(S2)`…（オフ画面/歌唱含む）; デュエット `(S1,S2)`
* **`<d>`**: ID・動作・演技はタグ外; タグ内は言語タグと原文
* **`<d>` 内句読点**: `, . ? !` を保持; 文末は `.` `?` `!`; 不明は `[unclear]`; 省略号は避ける
* **ボイスオーバー**: `says in an off-screen voiceover` と唇が閉じたまま; 跨ぎは `<scenetrans>`
* **複数話者 + オーディオ参照**: 誤割当あり; タイムコードより可視イベントに結び付け; 必要なら話者別に外部生成して参照

## プロンプト埋め込み

[ComfyUI#15697](https://github.com/Comfy-Org/ComfyUI/pull/15697) で `embedding:name` を H3 プロンプトで使用。`ComfyUI/models/embeddings/` に配置。

[Comfy-Org/MiniMax-H3/embeddings](https://huggingface.co/Comfy-Org/MiniMax-H3/tree/main/embeddings) に **10** 件のコミュニティスタイル（[silveroxides](https://huggingface.co/silveroxides)、[discussion #50](https://huggingface.co/Comfy-Org/MiniMax-H3/discussions/50); 非公式）。トリガーは拡張子なしファイル名:

| 埋め込み | 効果（名前より） |
| - | - |
| `minimaxh3_art_is_explosion` | 爆発的アート構図 |
| `minimaxh3_blooming_flowers` | 花が咲く |
| `minimaxh3_bullet_time` | バレットタイム |
| `minimaxh3_dark_magic` | ダークマジック |
| `minimaxh3_fire_breath` | 火を吐く |
| `minimaxh3_four_seasons` | 四季の移り変わり |
| `minimaxh3_kiss_camera` | キスシーンのカメラ |
| `minimaxh3_spiral_ascent` | 螺旋上昇 |
| `minimaxh3_storm_magic` | ストームマジック |
| `minimaxh3_truman_show` | トルーマン・ショー風 |


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