> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/fr/modeles/minimax-h3.md).

# MiniMax-H3 : comment l’exécuter en local

Exécutez MiniMax-H3 en local pour générer des vidéos avec du son et entraînez un LoRA vidéo MiniMax-H3 avec Unsloth.

**MiniMax-H3** est le modèle vidéo ouvert de MiniMax. À partir d’un prompt textuel, il génère une vidéo et sa bande-son en même temps, avec, en option, des images de début et de fin ou des images, des vidéos et des fichiers audio de référence. Exécutez-le dans [Unsloth](https://unsloth.ai/docs/fr/desktop.md) avec le dépôt FP8 d’Unsloth, et entraînez votre propre LoRA MiniMax-H3 à partir de courts clips avec du son.

{% columns %}
{% column width="50%" %}

* Les clips sont à 24 images/s et durent de 5,2 à 14,4 s.
* Par défaut : **20 étapes**, **864 × 480**, 5,2 s.
* Une vidéo en 864 × 480 prend environ **30 s** sur une RTX PRO 6000.
* Entraînement LoRA : environ **36 min** pour 400 étapes, avec un pic de VRAM de 49,7 Go.

MiniMax-H3 : [FP8](https://huggingface.co/unsloth/MiniMax-H3-FP8) • [GGUF](https://huggingface.co/unsloth/MiniMax-H3-GGUF) • [Original](https://huggingface.co/MiniMaxAI/MiniMax-H3)

Testé avec Unsloth 2026.11.4 et une version compilée depuis main sur une RTX PRO 6000 (96 Go).
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fyc83EeZRTERrxk24F75C%2Fminimax-h3-out-forest.webp?alt=media" alt="Aerial view over a misty pine forest and a winding river at sunrise"><figcaption><p>Dépôt FP8, 864 × 480, 5,2 s (sans son dans l’aperçu)</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

#### Affinage LoRA de MiniMax-H3 — avant et après

[Affiner MiniMax-H3 : exemples avant et après](https://unsloth.ai/docs/fr/modeles/minimax-h3/fine-tune-minimax-h3.md#minimax-h3-lora-finetuning-before-and-after)

Unsloth vous permet également d’affiner MiniMax-H3 ! Par exemple, en 864 × 480, 5,2 s, 20 étapes, avec la seed 42, sur le modèle bf16 d’origine dans Unsloth. Prompt : « bbbstyle, un pré ensoleillé avec un grand chêne et un petit ruisseau, des oiseaux qui chantent ». Voici le style avant et après l’affinage :

<div><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FY40HyPvTZusQH0RDXU4I%2Fminimax-h3-lora-studio-before.webp?alt=media" alt="Without the LoRA: a realistic meadow with a big oak tree and a small stream under a blue sky"><figcaption><p>Sans LoRA</p></figcaption></figure> <figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FQxzr4zJRmMzlFE6OHCDi%2Fminimax-h3-lora-studio-after.webp?alt=media" alt="With the LoRA: the same meadow in a 3D animated film look, with a stylized oak tree, bright green grass and a small stream"><figcaption><p>Avec le LoRA bbbstyle, 200 étapes</p></figcaption></figure></div>

### Besoins en mémoire

| Tâche                     | Télécharger                                                                          | Total          | Mémoire GPU                                |
| ------------------------- | ------------------------------------------------------------------------------------ | -------------- | ------------------------------------------ |
| **Exécuter** (FP8 rapide) | Modèle vidéo INT8 : 20,3 Go ; encodeur de texte Qwen3-VL 32B INT8 : 27,1 Go ; VAEs   | environ 50 Go  | 54 Go utilisés                             |
| **Entraîner un LoRA**     | Dépôt bf16 d’origine : modèle vidéo 66,3 Go, encodeur de texte 66,7 Go, VAEs 11,1 Go | environ 144 Go | Pic de 49,7 Go ; 80 Go ou plus recommandés |

L’entraînement charge l’encodeur de texte de 63 Go une fois pour encoder les légendes, puis le libère avant de charger le modèle vidéo.

### Démarrage rapide

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FWti8xb1Y3sOQBfG8oXMd%2Fminimax-h3-flow.webp?alt=media" alt="Animation: pick MiniMax H3 (Fast FP8), choose Text and frames, type a prompt, click Generate and play the forest clip" width="563"><figcaption><p>Le flux Unsloth, accéléré</p></figcaption></figure>

{% stepper %}
{% step %}

#### Installer Unsloth

Utilisez l’application [Unsloth Desktop](https://unsloth.ai/docs/fr/desktop.md) ou installez depuis le terminal.

<a href="https://unsloth.ai/download" class="button primary" data-icon="down-to-bracket">Télécharger Unsloth</a>

macOS, Linux, WSL :

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

Windows PowerShell :

```powershell
irm https://unsloth.ai/install.ps1 | iex
```

Lancez Unsloth et ouvrez `http://localhost:8888`:

```bash
unsloth studio -H 0.0.0.0 -p 8888
```

{% endstep %}

{% step %}

#### Ouvrez

Ouvrir **Images** dans la barre latérale, puis cliquez sur **Vidéo** en haut à droite, ou accédez à `http://localhost:8888/video`.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FqCq3GkDxVruGcu5LGHPi%2Fminimax-h3-video-page.png?alt=media" alt="The Unsloth Video page with the Create tab open and no model loaded"><figcaption><p>La page Vidéo</p></figcaption></figure>
{% endstep %}

{% step %}

#### Choisir MiniMax-H3

Cliquez sur **Sélectionner un modèle vidéo**, recherchez `MiniMax-H3` et choisissez **MiniMax H3 (Fast FP8)**.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FbRd7iMQUQKMxQt8erID0%2Fminimax-h3-picker.png?alt=media" alt="Model picker search results for MiniMax-H3 with the Fast FP8, GGUF, FP8 and original entries" width="540"><figcaption><p>Sélecteur de modèle</p></figcaption></figure>

Choisissez un mode :

* **Texte et images** : un prompt, avec des images de début et de fin facultatives.
* **Références** : images, vidéos et audio de référence. Téléchargement distinct du modèle.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FG589ovJjwsvgaLILbmrH%2Fminimax-h3-mode.png?alt=media" alt="Dialog: Choose how MiniMax H3 should generate, with the Text and frames and References options" width="450"><figcaption><p>Boîte de dialogue du mode</p></figcaption></figure>
{% endstep %}

{% step %}

#### Définir le prompt et les paramètres

Décrivez la scène, la caméra et les sons. Choisissez une taille dans **Tailles d’entraînement** et une **Durée**. Unsloth renseigne les autres paramètres.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FA3ocFMljlYqyFZIVQnGg%2Fminimax-h3-settings.png?alt=media" alt="Create panel with the forest prompt, empty start and end frames, 864 by 480, 5.2 seconds and 124 frames, 24 fps, 20 steps, motion shift 12, audio shift 3 and seed 42" width="400"><figcaption><p>Paramètres de création</p></figcaption></figure>
{% endstep %}

{% step %}

#### Générer

Cliquez sur **Générer**. La vidéo est lue avec le son dans l’aperçu. Utilisez **Recette** pour consulter les paramètres et **Télécharger** pour l’enregistrer.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F1kKizKGOjO83IGdw1PAa%2Fminimax-h3-result.png?alt=media" alt="Finished video of a misty pine forest and river at sunrise in the Video page preview, with the gallery below"><figcaption><p>Résultat, graine 42</p></figcaption></figure>

La première vidéo nécessite quelques minutes pour compiler le modèle.
{% endstep %}
{% endstepper %}

Prompt : « Un lent plan aérien survole une forêt de pins brumeuse et une rivière sinueuse au lever du soleil. La lumière dorée perce le brouillard, les oiseaux chantent et l’eau dévale les rochers. Film documentaire cinématographique sur la nature. »

### Image de début, image de fin et références

* **Image de début** : la vidéo commence par votre image. Déposez-la dans **Image de début**.
* **Image de fin** : la vidéo se termine par votre image. Utilisez les deux pour passer d’une image à l’autre.
* **Références** : chargez MiniMax-H3 en mode **Références** pour guider la vidéo avec des images, des vidéos et des pistes audio.
* Les images doivent avoir un rapport compris entre 1:4 et 4:1. Décrivez dans le prompt le mouvement entre les images.

### Paramètres recommandés

| Paramètre                 | Valeur                                                                   |
| ------------------------- | ------------------------------------------------------------------------ |
| **Étapes**                | 20                                                                       |
| **Guidage**               | Non utilisé (distillé avec guidage)                                      |
| **Fréquence d’images**    | 24 images/s                                                              |
| **Durée**                 | De 5,2 s (124 images) à 14,4 s (345 images), par incréments de 17 images |
| **Taille**                | 864 × 480 pour commencer ; jusqu’à 1344 × 768 ou 1536 × 672              |
| **Décalage du mouvement** | 12                                                                       |
| **Décalage audio**        | 3                                                                        |
| **Graine**                | N’importe quel nombre pour reproduire un résultat                        |

#### T4 et autres GPU sans bf16

Utilisez l’entrée **GGUF** . Sans bf16, le dépôt FP8 et les poids d’origine repassent en float32 et nécessitent environ 288 Go de RAM système. Sur une machine moins puissante, Unsloth les refuse donc avant tout téléchargement et vous oriente vers la version GGUF (nécessite une version d’Unsloth ultérieure à 2026.11.4).

Sur une Colab T4 avec 15 Go, le GGUF **UD-Q2\_K\_XL** avec l’encodeur de texte Q2\_K\_M a généré un rendu de 864 x 480, 124 images, en 20 étapes, en environ **34 min** par clip, en utilisant environ 26 Go de RAM système.

### Entraîner un LoRA

Consultez [Affiner MiniMax-H3](https://unsloth.ai/docs/fr/modeles/minimax-h3/fine-tune-minimax-h3.md) pour savoir comment affiner MiniMax-H3. À titre d’exemple, voyez comment les deux vidéos ont chacune pris environ 10 min sur une RTX PRO 6000, chargement compris. La même paire avec la LoRA de 400 étapes se trouve à droite.

<div><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FQ9SnobeErT5EubX2JC3I%2Fminimax-h3-lora-meadow-before.webp?alt=media" alt="Without the LoRA: a realistic meadow with a big oak tree and a small stream under a blue sky"><figcaption><p>Sans LoRA</p></figcaption></figure> <figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FLrEdDhkeBntupm1TbjDb%2Fminimax-h3-lora-meadow-after.webp?alt=media" alt="With the LoRA: the same meadow in a 3D animated film look, with stylized oak trees, soft light and a small animated character"><figcaption><p>Avec la LoRA bbbstyle, 400 étapes</p></figcaption></figure></div>

#### Utiliser la LoRA

Voir [Affiner MiniMax-H3](https://unsloth.ai/docs/fr/modeles/minimax-h3/fine-tune-minimax-h3.md#use-the-lora)

#### En dehors d’Unsloth : diffusers

Voir [Affiner MiniMax-H3](https://unsloth.ai/docs/fr/modeles/minimax-h3/fine-tune-minimax-h3.md#outside-unsloth-diffusers)

### Dépannage

Voir [Affiner MiniMax-H3](https://unsloth.ai/docs/fr/modeles/minimax-h3/fine-tune-minimax-h3.md#troubleshooting)

<details>

<summary>MiniMax-H3 n’apparaît pas dans le sélecteur de modèles vidéo</summary>

[Mettez Unsloth à jour](https://unsloth.ai/docs/get-started/install/updating) et redémarrez-le. Si un modèle est chargé, cliquez sur **Recommandé** dans le sélecteur.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://unsloth.ai/docs/fr/modeles/minimax-h3.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
