Paramètre quality et optimisation des rendus

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

En plus du choix entre les modèles standard et pro, l’API de génération d’images propose un paramètre quality qui vous donne un contrôle supplémentaire sur le rendu. Ce paramètre influence le niveau de détail et le temps de génération de chaque image.

Le paramètre quality

Le point à retenir avant tout le reste : quality joue sur le temps de génération, pas sur le prix. Une image en low coûte le même tarif qu’une image en high sur le même modèle. Ce paramètre n’est donc pas un levier d’économie mais un levier de latence — ce qui change complètement la façon de l’utiliser.

• low : génération rapide, moins de détails. Idéal pour le prototypage.
• medium : équilibre entre qualité et vitesse. Bon pour la plupart des usages.
• high : rendu maximal, temps de génération plus long. Pour les visuels finaux.

# Qualité basse pour un brouillon rapide
response_low = client.images.generate(
    model="grok-imagine-image",
    prompt="Maquette de site web e-commerce, style wireframe",
    quality="low"
)

# Qualité moyenne pour un usage courant
response_medium = client.images.generate(
    model="grok-imagine-image",
    prompt="Illustration d'une application mobile de fitness",
    quality="medium"
)

# Qualité haute pour un visuel final
response_high = client.images.generate(
    model="grok-imagine-image-quality",
    prompt="Affiche publicitaire pour un parfum de luxe, rendu photoréaliste",
    quality="high",
    resolution="2k"
)

Combinaison modèle + quality + resolution

Trois paramètres, deux effets à ne pas confondre. Le modèle décide du prix et du débit ; quality et resolution décident du temps et du rendu. Une fois cette distinction en tête, l’arbitrage devient simple : on choisit le modèle d’après le budget et le volume, puis les deux autres d’après ce que l’image doit supporter.

Workflow d’optimisation en 3 étapes

Le workflow en trois temps applique ce principe : on cherche la bonne idée là où c’est rapide, on affine, on ne paie le rendu long que sur l’image retenue. L’économie porte surtout sur le modèle — puisque quality ne change pas le tarif — et sur le temps passé à attendre des rendus haute qualité qui seront écartés.

Étape 1 : Explorer (low cost)

# Tester plusieurs prompts rapidement
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,
        quality="low",
        n=3
    )
    # Coût : 3 x 0,02 $ = 0,06 $ par prompt

Étape 2 : Raffiner (medium cost)

# Le prompt gagnant en qualité moyenne avec variations
best_prompt = "Un bras robotique versant du café, style réaliste"

response = client.images.generate(
    model="grok-imagine-image",
    prompt=best_prompt,
    quality="medium",
    n=5,
    resolution="1k"
)
# Coût : 5 x 0,02 $ = 0,10 $

Étape 3 : Finaliser (high cost)

# Le prompt final en qualité maximale
response = client.images.generate(
    model="grok-imagine-image-quality",
    prompt=best_prompt + ", éclairage cinématographique, détails mécaniques fins",
    quality="high",
    resolution="2k",
    n=2
)
# Coût : 2 x 0,05 $ = 0,10 $

Coût total du workflow : environ 0,38 $ pour un visuel final optimisé, au lieu de 0,80 $ si vous aviez généré les 16 images en pro/high directement.

Automatiser le choix de qualité

Centraliser ce choix dans une fonction évite qu’il se disperse dans le code, où il devient impossible à réviser. Le jour où les tarifs changent ou qu’un modèle s’ajoute, un seul endroit est à modifier — et vous pouvez répondre à « pourquoi cette image a-t-elle coûté ça ? » en lisant une seule fonction.

def generate_smart(prompt, usage="web"):
    """Génère une image avec des paramètres adaptés à l'usage."""
    configs = {
        "prototype": {"model": "grok-imagine-image", "quality": "low", "resolution": "1k"},
        "web": {"model": "grok-imagine-image", "quality": "medium", "resolution": "1k"},
        "social": {"model": "grok-imagine-image", "quality": "high", "resolution": "1k"},
        "marketing": {"model": "grok-imagine-image-quality", "quality": "high", "resolution": "1k"},
        "print": {"model": "grok-imagine-image-quality", "quality": "high", "resolution": "2k"},
    }

    config = configs.get(usage, configs["web"])
    return client.images.generate(prompt=prompt, **config)

Points clés à retenir

• Le paramètre quality accepte low, medium et high
• Combinez modèle, quality et resolution selon l’usage final
• Utilisez un workflow en 3 étapes : explorer (low), raffiner (medium), finaliser (high)
• Les prototypes en low quality coûtent autant mais sont plus rapides
• Automatisez le choix des paramètres avec une fonction de configuration