# Topaz Amélioration d’Image

Topaz Image Enhance applique une mise à l'échelle et une amélioration d'image conformes aux standards du secteur à une seule image d'entrée en utilisant les modèles Topaz. Il envoie l'image à l'API Topaz, la traite avec le modèle sélectionné et renvoie le résultat amélioré. Vous pouvez choisir parmi quatre modèles : Reimagine, Bloom 2, Wonder 3.5 et Wonder 4.

## Entrées

### Entrées communes

| Paramètre | Description | Type de données | Requis | Plage |
|-----------|-------------|-----------|----------|-------|
| `image` | L'image d'entrée à améliorer. Une seule image d'entrée est prise en charge. | IMAGE | Oui | Image unique |
| `modèle` | Le modèle d'amélioration Topaz à utiliser. Le modèle sélectionné détermine quels paramètres spécifiques au modèle apparaissent. | DYNAMIC_COMBO | Oui | `"Reimagine"`<br>`"Bloom 2"`<br>`"Wonder 3.5"`<br>`"Wonder 4"` |
| `largeur de sortie` | Une valeur nulle signifie un calcul automatique (généralement la taille d'origine ou une mise à l'échelle proportionnelle à `output_height` si spécifié). Wonder 3.5 et Wonder 4 prennent en charge des facteurs d'agrandissement de 1x à 6x, et Bloom 2 de 1x à 12x. Bloom 2, Wonder 3.5 et Wonder 4 préservent toujours le rapport d'aspect de l'entrée : si les deux tailles sont définies et que leur rapport diffère, l'agrandissement le plus élevé l'emporte, de sorte que la sortie est plus grande que la taille demandée et que le prix est plus élevé que celui de la taille demandée. (par défaut : 0) | INT | Non | 0 à 32000 |
| `hauteur de sortie` | Une valeur nulle signifie une sortie à la même hauteur que l'original ou une mise à l'échelle proportionnelle à `output_width` si spécifié. Wonder 3.5 et Wonder 4 prennent en charge des facteurs d'agrandissement de 1x à 6x, et Bloom 2 de 1x à 12x. Bloom 2, Wonder 3.5 et Wonder 4 préservent toujours le rapport d'aspect de l'entrée : si les deux tailles sont définies et que leur rapport diffère, l'agrandissement le plus élevé l'emporte, de sorte que la sortie est plus grande que la taille demandée et que le prix est plus élevé que celui de la taille demandée. (par défaut : 0) | INT | Non | 0 à 32000 |

### Entrées Reimagine

Ces paramètres s'appliquent lorsque `model` est défini sur `"Reimagine"`.

| Paramètre | Description | Type de données | Requis | Plage |
|-----------|-------------|-----------|----------|-------|
| `prompt` | Invite textuelle facultative pour guider l'agrandissement créatif. (par défaut : "") | STRING | Oui | Tout texte |
| `creativity` | Niveau de créativité pour l'amélioration. (par défaut : 3) | INT | Oui | 1 à 9 |
| `subject_detection` | Mode de détection du sujet (avancé). | COMBO | Oui | `"All"`<br>`"Foreground"`<br>`"Background"` |
| `face_enhancement` | Améliorer les visages (s'ils sont présents) pendant le traitement. (par défaut : True) | BOOLEAN | Oui | true<br>false |
| `face_enhancement_creativity` | Définit le niveau de créativité pour l'amélioration des visages. (par défaut : 0.0) | FLOAT | Oui | 0.0 à 1.0 |
| `face_enhancement_strength` | Contrôle la netteté des visages améliorés par rapport à l'arrière-plan. (par défaut : 1.0) | FLOAT | Oui | 0.0 à 1.0 |
| `face_preservation` | Préserver l'identité faciale des sujets. (par défaut : True) | BOOLEAN | Oui | true<br>false |
| `color_preservation` | Préserver les couleurs d'origine. (par défaut : True) | BOOLEAN | Oui | true<br>false |
| `crop_to_fill` | Par défaut, l'image est mise en boîte aux lettres lorsque le rapport d'aspect de sortie diffère. Activez cette option pour rogner l'image afin de remplir les dimensions de sortie. (par défaut : False) | BOOLEAN | Oui | true<br>false |

### Entrées Bloom 2

Ces paramètres s'appliquent lorsque `model` est défini sur `"Bloom 2"`.

| Paramètre | Description | Type de données | Requis | Plage |
|-----------|-------------|-----------|----------|-------|
| `prompt` | Invite textuelle facultative pour la génération. Laissez vide pour générer automatiquement une invite à partir de l'image d'entrée. (par défaut : "") | STRING | Oui | Tout texte |
| `creativity` | 1 correspond à une amélioration retenue, 9 à une réinterprétation marquée avec des détails nouvellement générés. (par défaut : 3) | INT | Oui | 1 à 9 |
| `seed` | Graine pour une génération reproductible. (par défaut : 2) | INT | Oui | 1 à 2000 |
| `color_preservation` | Préserver les couleurs d'origine. (par défaut : True) | BOOLEAN | Oui | true<br>false |
| `grain` | Ajouter du grain à l'image de sortie. (par défaut : False) | BOOLEAN | Oui | true<br>false |
| `grain_model` | Modèle de grain à utiliser. Ignoré si le grain est désactivé. | COMBO | Oui | `"silver"`<br>`"gaussian"`<br>`"grey"` |
| `grain_strength` | Intensité de l'effet de grain. Ignoré si le grain est désactivé. (par défaut : 0.5) | FLOAT | Oui | 0.0 à 1.0 |
| `grain_size` | Taille des particules de grain. Ignoré si le grain est désactivé. (par défaut : 1.0) | FLOAT | Oui | 1.0 à 5.0 |
| `grain_density` | Densité de l'effet de grain. Ignoré si le grain est désactivé. (par défaut : 0.5) | FLOAT | Oui | 0.0 à 1.0 |

### Entrées Wonder 3.5

Ces paramètres s'appliquent lorsque `model` est défini sur `"Wonder 3.5"`.

| Paramètre | Description | Type de données | Requis | Plage |
|-----------|-------------|-----------|----------|-------|
| `enhancement_strength` | Niveau d'amélioration pour diverses conditions d'entrée. (par défaut : "high") | COMBO | Oui | `"low"`<br>`"medium"`<br>`"high"` |
| `grain` | Ajouter du grain à l'image de sortie. (par défaut : False) | BOOLEAN | Oui | true<br>false |
| `grain_model` | Modèle de grain à utiliser. Ignoré si le grain est désactivé. | COMBO | Oui | `"silver"`<br>`"gaussian"`<br>`"grey"` |
| `grain_strength` | Intensité de l'effet de grain. Ignoré si le grain est désactivé. (par défaut : 0.5) | FLOAT | Oui | 0.0 à 1.0 |
| `grain_size` | Taille des particules de grain. Ignoré si le grain est désactivé. (par défaut : 1.0) | FLOAT | Oui | 1.0 à 5.0 |
| `grain_density` | Densité de l'effet de grain. Ignoré si le grain est désactivé. (par défaut : 0.5) | FLOAT | Oui | 0.0 à 1.0 |

**Remarque :** Une seule image d'entrée est prise en charge ; le nœud génère une erreur si le lot d'entrée contient plus d'une image. Les paramètres de grain (`grain_model`, `grain_strength`, `grain_size`, `grain_density`) sont ignorés sauf si `grain` est activé. Pour Bloom 2, laisser `prompt` vide génère automatiquement une invite à partir de l'image d'entrée. Wonder 4 n'expose que les entrées communes. La sortie est limitée à 179 mégapixels et à 32000 pixels par côté.

## Sorties

| Nom de sortie | Description | Type de données |
|-------------|-------------|-----------|
| `IMAGE` | L'image améliorée et agrandie renvoyée par l'API Topaz. | IMAGE |

> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TopazImageEnhanceV2/fr.md)

---
**Source fingerprint (SHA-256):** `dd109d31ea4ab7928058414c3a62ae3829f879354ebdce329b599aacb9804d1b`
