Paramètre de qualité et optimisation du rendu
In questa pagina
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, pour un modèle « pro » désormais retiré. Selon la documentation actuelle de xAI,qualityest spécifique à Imagine 2.0, acceptelow,mediumetauto, et chaque image est facturée selon la qualité à laquelle elle est servie.
Contrôler 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
quality est accepté par grok-imagine-image-2.0, tant pour la génération que pour l’édition. Trois valeurs possibles :
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: 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éfinis explicitement la qualité plutôt que de laisser auto décider. Avec le SDK OpenAI pointé vers l’API xAI, cela passe 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 fixe le prix de base et les fonctionnalités disponibles, quality détermine le niveau de détail pour Imagine 2.0 (et son tarif), et resolution définit la netteté 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
Trouve la bonne idée là où c’est bon marché, affine-la, et ne paie 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é
Centralise ce choix dans une fonction pour éviter qu’il ne se disperse dans ton 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
Punti chiave
qualityest spécifique à Imagine 2.0 et acceptelow,mediumetauto(valeur par défaut)- L’image est facturée selon la qualité servie : définis explicitement la qualité pour contrôler la facture
- Avec le SDK OpenAI,
qualityetresolutionpassent viaextra_body - Flux en 3 étapes : explorer avec Imagine 1.0, affiner en
low, finaliser enmedium - Centralise la sélection des paramètres dans une fonction de configuration