> 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/notions-de-base/diffusion-image.md).

# Comment exécuter localement des modèles de diffusion d’images avec Unsloth

Générez et modifiez des images IA sur votre propre ordinateur à l'aide de modèles de diffusion, sans écrire de code ni configurer un flux de travail complexe. Avec Unsloth, vous pouvez exécuter des modèles comme **MiniMax-H3**, [**Qwen-Image-2.1**](/docs/fr/modeles/qwen-image-2.1.md)**, Z-Image** et **FLUX** localement avec la prise en charge des **GGUF**, **FP8**, **LoRA**, des images de référence, et plus encore. Commencez par une invite textuelle ou une image existante, puis créez, transformez, modifiez, étendez, améliorez la résolution ou affinez des images à l'aide des outils et des flux de travail pris en charge par chaque modèle.

Choisissez parmi **MiniMax-H3**, [**Qwen-Image-2.1**](/docs/fr/modeles/qwen-image-2.1.md)**,** **Z-Image, LTX, FLUX, SDXL et plus encore**.

Pour créer votre propre LoRA, affinez un modèle pris en charge sur votre jeu de données. Voir <mark style="color:bleu;">Affiner un modèle d'image</mark> pour en savoir plus.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FmG2HFa4hRVF1LA8AWcZc%2Fimage.png?alt=media&amp;token=250f56c3-ac31-4e7c-a733-8024a4e4fc3f" alt="" width="563"><figcaption></figcaption></figure></div>

### ⚡ Démarrage rapide

{% stepper %}
{% step %}

### **Installer ou mettre à jour**

L’application de bureau est le moyen le plus simple pour commencer.

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

Suivez le programme d'installation, puis ouvrez l'application depuis vos applications. Si elle est déjà installée, assurez-vous qu'elle est à jour avant de continuer.

**Ligne de commande**

Vous préférez le terminal ? Exécutez la commande correspondant à votre système d'exploitation. La même commande mettra à jour une installation existante.

**MacOS, Linux, WSL :**

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

**Windows PowerShell :**

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

#### Lancer Unsloth

Une fois l'installation terminée, lancez Unsloth :

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

Ouvrez `http://localhost:8888` s'il ne s'ouvre pas automatiquement.
{% endstep %}

{% step %}

### Ouvrir Images

Sélectionnez **Images** dans la barre latérale. Le **Créer** flux de travail s'ouvre par défaut.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FEFCApsTzrL81lOcdd298%2Fimage.png?alt=media&amp;token=07fa0438-55f4-46ec-b055-2f4b6532df96" alt="" width="375"><figcaption></figcaption></figure></div>

Nous sommes maintenant prêts à passer à l'étape suivante.
{% endstep %}

{% step %}

### Choisissez un modèle

Ouvrez **Sélectionnez un modèle d'image** et choisissez un modèle dans le sélecteur.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F9rVVPAiJKVsY01x1oKYL%2Fimage.png?alt=media&amp;token=4d523fdd-7bb3-493f-9377-e12dd989c865" alt="" width="375"><figcaption></figcaption></figure></div>

Le **Recommandé** L'onglet Recommandé est un bon point de départ.\
\
Pour les modèles GGUF, la meilleure taille pour votre appareil est également marquée **recommandée**. Les tailles susceptibles de s'exécuter lentement ou de ne pas tenir sont marquées **SERRÉ** ou **OOM**.
{% endstep %}

{% step %}

### Saisissez une invite

Décrivez l'image que vous souhaitez générer.

Par exemple :

> Vue de dessus d'un étang paisible de carpes koï dans un jardin japonais, carpes koï orange, blanches et noires nageant sous l'eau claire, entourées de pas japonais couverts de mousse et de petits ponts en bois, avec des feuilles d'érable rouges flottant à la surface. Lumière vive de midi, couleur saturée, reflets nets. Illustration de dessin animé fantaisiste, 50 mm.

Vous pouvez conserver les paramètres recommandés pour votre première image.
{% endstep %}

{% step %}

### Générez votre première image

Sélectionnez **Générer**. La première génération peut prendre plus de temps pendant le téléchargement et le chargement du modèle.

Votre résultat apparaîtra dans la galerie, où vous pourrez consulter ses paramètres ou le télécharger.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FT7kNykpOms4GymzxY4jT%2Fimage.png?alt=media&amp;token=8a2bf1bb-26d2-4f5c-a43f-6f5fec9005dc" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### ⭐ Fonctionnalités

Les flux de travail disponibles dépendent du modèle chargé. Les flux de travail non pris en charge sont masqués automatiquement.

#### Créer et modifier des images

* **Créer :** Générez une image à partir d'une invite textuelle.
* **Transformer :** Utilisez une image existante comme point de départ pour une nouvelle génération.
* **Inpainting :** Sélectionnez et régénérez une partie d'une image.
* **Étendre :** Générez du contenu au-delà du canevas d'origine.
* **Mise à l'échelle :** Augmente la résolution d'une image.
* **Référence :** Guidez une génération avec une ou plusieurs images de référence.
* **Modifier :** Décrivez les modifications que vous souhaitez apporter à une image.

**Modifier** nécessite un modèle compatible comme Qwen-Image-Edit ou FLUX.1 Kontext.

#### LoRA et ControlNet

Chargez des LoRA compatibles pour ajouter un personnage, un sujet ou un style visuel à vos générations. Ajustez le poids de la LoRA pour contrôler son influence sur le résultat.

Les modèles pris en charge peuvent également utiliser ControlNet pour guider la structure d'une image. Ajustez sa force pour contrôler à quel point le résultat suit l'image de guidage.

#### Galerie

Les images générées sont enregistrées dans la galerie locale. Ouvrez un résultat pour afficher son invite et ses paramètres, puis sélectionnez **Recette** pour restaurer sa configuration de génération ou télécharger l'image.

### Modèles et flux de travail pris en charge

| Ce que vous voulez faire          | Modèles pour commencer            |
| --------------------------------- | --------------------------------- |
| Générer ou transformer des images | Z-Image, Qwen-Image, FLUX.1, SDXL |
| Modifier à l'aide d'instructions  | Qwen-Image-Edit, FLUX.1 Kontext   |
| Utiliser des images de référence  | FLUX.2 klein                      |

D'autres modèles sont disponibles dans le sélecteur de modèles. Les formats et les flux de travail varient selon le modèle, et les flux de travail non pris en charge sont masqués automatiquement.

### Paramètres de génération

Les paramètres par défaut sont un bon point de départ. Cependant, il est possible d'ajuster les paramètres pour obtenir le meilleur résultat. Voici les principaux paramètres que vous voudrez peut-être modifier :

| Paramètre                                 | Ce que cela modifie                                                                                                    |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Invite**                                | Décrit l'image que vous souhaitez créer. Dans **Modifier**, cela devient l'instruction à suivre.                       |
| **Rapport hauteur/largeur et résolution** | Définit la forme et la taille de l'image. Les images plus grandes utilisent plus de mémoire et prennent plus de temps. |
| **Étapes**                                | Contrôle le temps que le modèle passe à générer. Davantage d'étapes n'améliorent pas toujours le résultat.             |
| **Guidage**                               | Contrôle à quel point la consigne guide le résultat. Certains modèles fonctionnent mieux à `0`.                        |
| **Graine**                                | Aide à recréer un résultat. Laissez-le vide pour utiliser une graine aléatoire.                                        |

<details>

<summary>Paramètres avancés de génération</summary>

Ces contrôles modifient la façon dont le modèle s'exécute sur votre appareil. Ajustez-les pour réduire l'utilisation de la mémoire, améliorer les performances ou dépanner la génération.

| Paramètre            | Ce que cela modifie                                                                                                                                                                          |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Vitesse**          | Contrôle la compilation et les optimisations de performance. Les modes compilés peuvent prendre plus de temps lors de la première génération.                                                |
| **Précision**        | Modifie le format numérique utilisé pour exécuter le modèle. Une précision plus faible peut réduire l'utilisation de la mémoire. Les options disponibles dépendent du modèle et du matériel. |
| **Attention**        | Sélectionne l'implémentation d'attention utilisée pendant la génération.                                                                                                                     |
| **Mémoire**          | Équilibre la vitesse de génération par rapport à l'utilisation de la mémoire GPU. Essayez **VRAM faible** si un modèle est proche de votre limite de mémoire.                                |
| **Cache d'étapes**   | Réutilise certains calculs entre les étapes de diffusion pour améliorer la vitesse de génération.                                                                                            |
| **Déchargement CPU** | Déplace des parties du modèle vers la mémoire système. Cela réduit l'utilisation de la mémoire GPU, mais peut ralentir la génération.                                                        |

</details>

### ⚠️ Dépannage

<details>

<summary>Les images n'apparaissent pas</summary>

Mettez à jour vers la dernière version, puis redémarrez l'application. Voir [Mise à jour d'Unsloth](https://unsloth.ai/docs/get-started/install/updating) pour les instructions.

</details>

<details>

<summary>Un modèle ne se télécharge pas ou ne se charge pas</summary>

Certains modèles d'image sont volumineux et mettent du temps à être téléchargés. Vérifiez que vous disposez de suffisamment d'espace de stockage libre et d'une connexion Internet stable.

Certains modèles exigent également que vous acceptiez leur licence sur Hugging Face et que vous ajoutiez un jeton Hugging Face avant de les télécharger.

</details>

<details>

<summary>Le modèle manque de mémoire</summary>

Essayez une quantification GGUF plus petite ou une version 4 bits du modèle. Pour les modèles GGUF, commencez par la taille marquée **recommandée**.

Vous pouvez aussi :

* Réduisez la résolution de l'image.
* Conservez la taille du lot à `1`.
* Fermez les autres applications qui utilisent le GPU.
* Choisissez un modèle plus petit.

Un **SERRÉ** modèle peut utiliser la mémoire système et s'exécuter plus lentement. Un modèle marqué **OOM** a peu de chances de tenir.

</details>

<details>

<summary>Un flux de travail est manquant</summary>

Les flux de travail disponibles dépendent du modèle chargé. Les flux de travail non pris en charge n'apparaîtront pas.

Par exemple, l'édition par instructions nécessite un modèle comme Qwen-Image-Edit ou FLUX.1 Kontext.

</details>

### ❓ FAQ

<details>

<summary>La génération d'images s'exécute-t-elle localement ?</summary>

Oui. Une fois qu'un modèle est téléchargé, la génération d'images s'exécute sur votre appareil.

</details>

<details>

<summary>Quelle est la différence entre Transformer et Modifier ?</summary>

**Transformer** redessine une image existante à l'aide d'une invite qui décrit le résultat complet.

**Modifier** suit des instructions telles que changer un arrière-plan ou ajouter un objet. Cela nécessite un modèle d'édition compatible.

</details>

<details>

<summary>Puis-je entraîner ma propre LoRA d'image ?</summary>

Oui. Affinez un modèle pris en charge sur vos propres images, puis chargez la LoRA terminée dans **Créer**.

Voir « Affiner un modèle d'image » pour en savoir plus.

</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/notions-de-base/diffusion-image.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.