Paramètre de qualité et optimisation du rendu
Na tej strani
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, 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 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é réellement servie.
Pour maîtriser à la fois le rendu et la facture, définis explicitement la qualité au lieu 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="E-commerce website mockup, wireframe style",
)
# Visuel standard : Imagine 2.0, basse qualité
courant = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Illustration of a mobile fitness app",
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="Advertising poster for a luxury perfume, photorealistic render",
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 = [
"A robot barista making coffee, cartoon style",
"A robotic arm pouring coffee, realistic style",
"A mechanical hand holding a steaming cup, steampunk style",
]
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 = "A robotic arm pouring coffee, realistic style"
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 + ", cinematic lighting, fine mechanical details",
n=2,
extra_body={"quality": "medium", "resolution": "2k"},
)
# Coût : 2 images au tarif "medium" actuel
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
Ključne ugotovitve
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