Paramètre de qualité et optimisation du rendu
Pe această pagină
Leçon réécrite le 2 novembre 2026. La version précédente décrivait une valeur
highet un paramètrequalitysans impact sur le prix, destinés à un modèle « pro » désormais retiré. Selon la documentation actuelle de xAI,qualityest spécifique à Imagine 2.0, accepte les valeurslow,mediumetauto, et chaque image est facturée selon la qualité à laquelle elle est servie.
Contrôle de la qualité de génération

Dans l’application Grok, le sélecteur Vitesse / Qualité arbitre entre rapidité et finesse. Via l’API, cet équilibre repose sur deux choix : le modèle (Imagine 1.0 ou Imagine 2.0) et, pour Imagine 2.0, le paramètre quality.
Le paramètre quality
Le paramètre quality est accepté par grok-imagine-image-2.0, tant pour la génération que pour l’édition. Trois valeurs sont disponibles :
low: le réglage le moins cher pour Imagine 2.0 (0,04 $ par image aux tarifs affichés) et la destination des requêtes issues de l’ancien modèle « pro » ;medium: alloue plus de puissance de calcul par image pour des détails plus fins ; à réserver aux visuels où la qualité prime sur le coût ;auto: la valeur par défaut lorsque le paramètre est omis ; elle sert actuellementlowen génération etmediumen édition, et l’image est facturée selon la qualité effectivement servie.
Pour maîtriser à la fois le rendu et la facture, définissez explicitement la qualité plutôt que de laisser auto décider. Avec le SDK OpenAI pointé vers l’API xAI, cela se transmet via extra_body :
# Brouillon rapide : Imagine 1.0, le moins cher
brouillon = client.images.generate(
model="grok-imagine-image",
prompt="Maquette de site e-commerce, style wireframe",
)
# Visuel standard : Imagine 2.0, basse qualité
courant = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Illustration d'une application mobile de fitness",
extra_body={"quality": "low"},
)
# Visuel final : Imagine 2.0, qualité moyenne, résolution 2k
final = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Affiche publicitaire pour un parfum de luxe, rendu photoréaliste",
extra_body={"quality": "medium", "resolution": "2k"},
)
Combinaison Modèle + quality + résolution
Trois paramètres, trois effets : le modèle définit le prix de base et les fonctionnalités disponibles, quality le niveau de détail pour Imagine 2.0 (et son tarif), et resolution la définition de l’image (1k par défaut, ou 2k).
| Cas d’usage | Modèle | Qualité | Résolution |
|---|---|---|---|
| Prototype rapide | Imagine 1.0 | — | 1k |
| Contenu web | Imagine 1.0 | — | 1k |
| Réseaux sociaux | Imagine 2.0 | low | 1k |
| Visuel marketing | Imagine 2.0 | medium | 1k |
| Impression, affiche | Imagine 2.0 | medium | 2k |
Flux de travail d’optimisation en 3 étapes
Trouvez la bonne idée là où c’est bon marché, affinez-la, et ne payez le rendu le plus cher que pour l’image sélectionnée.
Étape 1 : Explorer
prompts_candidats = [
"Un robot barista préparant un café, style cartoon",
"Un bras robotique versant du café, style réaliste",
"Une main mécanique tenant une tasse fumante, style steampunk",
]
for prompt in prompts_candidats:
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=3,
)
# Coût : 3 x 0,02 $ = 0,06 $ par prompt
Étape 2 : Affiner
best_prompt = "Un bras robotique versant du café, style réaliste"
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt=best_prompt,
n=4,
extra_body={"quality": "low", "resolution": "1k"},
)
# Coût : 4 x 0,04 $ = 0,16 $
Étape 3 : Finaliser
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt=best_prompt + ", éclairage cinématographique, détails mécaniques fins",
n=2,
extra_body={"quality": "medium", "resolution": "2k"},
)
# Coût : 2 images au tarif actuel "medium"
Les deux premières étapes coûtent 0,34 $ pour neuf brouillons et quatre variantes ; seules les deux images finales sont facturées au tarif medium.
Automatiser la sélection de la qualité
Centralisez ce choix dans une fonction pour éviter qu’il ne se disperse dans le code. Si les tarifs changent ou qu’un modèle est ajouté, une seule modification suffit.
CONFIGS = {
"prototype": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
"web": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
"social": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "low", "resolution": "1k"}},
"marketing": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "1k"}},
"print": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "2k"}},
}
def generate_smart(prompt, usage="web"):
"""Génère une image avec des paramètres adaptés au cas d'usage."""
config = CONFIGS.get(usage, CONFIGS["web"])
return client.images.generate(prompt=prompt, **config)
Sources officielles : Génération d’images — Qualité · Retrait de grok-imagine-image-quality le 2 novembre 2026 · Tarification
Puncte cheie
qualityest spécifique à Imagine 2.0 et acceptelow,mediumetauto(valeur par défaut)- L’image est facturée selon la qualité servie : définissez explicitement la qualité pour contrôler la facture
- Avec le SDK OpenAI,
qualityetresolutionse transmettent viaextra_body - Flux en 3 étapes : explorer avec Imagine 1.0, affiner en
low, finaliser enmedium - Centralisez la sélection des paramètres dans une fonction de configuration