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 paramètre quality accepte trois valeurs :

• 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-pro",
    prompt="Affiche publicitaire pour un parfum de luxe, rendu photoréaliste",
    quality="high",
    resolution="2k"
)

Combinaison modèle + quality + resolution

Ces trois paramètres interagissent pour déterminer le résultat final :

Workflow d’optimisation en 3 étapes

Voici une approche méthodique pour obtenir le meilleur résultat au moindre coût :

É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-pro",
    prompt=best_prompt + ", éclairage cinématographique, détails mécaniques fins",
    quality="high",
    resolution="2k",
    n=2
)
# Coût : 2 x 0,07 $ = 0,14 $

Coût total du workflow : environ 0,60 $ pour un visuel final optimisé, au lieu de 0,70 $ si vous aviez tout fait en pro/high directement.

Automatiser le choix de qualité

Vous pouvez créer une fonction qui sélectionne automatiquement les paramètres selon le contexte :

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-pro", "quality": "high", "resolution": "1k"},
        "print": {"model": "grok-imagine-image-pro", "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