Paramètre quality et optimisation des rendus

Leçon réécrite le 2 novembre 2026. La version précédente décrivait une valeur high et un paramètre quality sans effet sur le prix, sur un modèle « pro » aujourd’hui retiré. Selon la documentation xAI du jour, quality est propre à Imagine 2.0, accepte low, medium et auto, et chaque image est facturée à la qualité à laquelle elle est servie.

Contrôler la qualité de génération

Dans l’application Grok, le sélecteur Speed / Quality arbitre entre rapidité et finesse. Dans l’API, cet arbitrage passe par 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, sur la génération comme sur l’édition. Trois valeurs :

• low : le réglage le moins cher d’Imagine 2.0 (0,04 $ l’image au tarif affiché), et celui vers lequel sont redirigées les requêtes de l’ancien modèle « pro » ;
• medium : davantage de calcul par image pour des détails plus fins, à réserver aux images où la qualité compte plus que le coût ;
• auto : la valeur par défaut quand le paramètre est omis ; elle sert aujourd’hui low en génération et medium en édition, et l’image est facturée à la qualité servie.

Pour maîtriser à la fois le rendu et la facture, fixez la qualité explicitement plutôt que de laisser auto décider. Avec le SDK OpenAI pointé vers l’API xAI, elle passe par extra_body :

# Brouillon rapide : Imagine 1.0, le moins cher
brouillon = client.images.generate(
    model="grok-imagine-image",
    prompt="Maquette de site web e-commerce, style wireframe",
)

# Visuel courant : Imagine 2.0 en qualité basse
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 en 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 + resolution

Trois paramètres, trois effets : le modèle fixe le prix de base et les fonctions disponibles, quality le niveau de détail d’Imagine 2.0 (et son tarif), resolution la définition de l’image (1k par défaut, ou 2k).

Workflow d’optimisation en 3 étapes

On cherche la bonne idée là où c’est bon marché, on affine, et on ne paie le rendu le plus coûteux que sur l’image retenue.

É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 : Raffiner

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 « medium » de la grille en vigueur

Les deux premières étapes coûtent 0,34 $ pour neuf brouillons et quatre variantes ; seules les deux images finales sont payées au tarif medium.

Automatiser le choix de qualité

Centraliser ce choix dans une fonction évite qu’il se disperse dans le code. Le jour où les tarifs changent ou qu’un modèle s’ajoute, un seul endroit est à modifier.

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 à l'usage."""
    config = CONFIGS.get(usage, CONFIGS["web"])
    return client.images.generate(prompt=prompt, **config)

Sources officielles : Image Generation — Quality · grok-imagine-image-quality Retirement on November 2, 2026 · Pricing

Points clés à retenir

• quality est propre à Imagine 2.0 et accepte low, medium et auto (valeur par défaut)
• L’image est facturée à la qualité servie : fixez la qualité explicitement pour maîtriser la facture
• Avec le SDK OpenAI, quality et resolution passent par extra_body
• Workflow en 3 étapes : explorer avec Imagine 1.0, raffiner en low, finaliser en medium
• Centralisez le choix des paramètres dans une fonction de configuration