Ratios, résolutions et formats de sortie

Maîtriser les dimensions de vos images

Le choix du ratio d’aspect et de la résolution détermine directement l’apparence et l’utilisation de vos images générées. L’API Grok Imagine offre une grande flexibilité avec de nombreux ratios prédéfinis et deux niveaux de résolution.

Ratios d’aspect disponibles

Le ratio se choisit d’après la destination, et il se choisit avant de générer. Recadrer après coup une image carrée en bannière panoramique ampute la composition que le modèle avait construite pour un carré : le sujet se retrouve décentré, les marges disparaissent. Générer directement au bon format coûte le même prix et donne une image pensée pour ses proportions.

Des ratios supplémentaires sont également disponibles pour des cas spécifiques comme les écrans de smartphones : 9:19.5, 19.5:9, 9:20 et 20:9.

Résolutions : 1k vs 2k

Entre 1k et 2k, la question n’est pas « laquelle est la meilleure » mais « où cette image sera-t-elle regardée ». Sur un écran, la différence est invisible pour l’immense majorité des usages web, et le 2k ne coûte que du temps de génération supplémentaire. Elle devient en revanche décisive à l’impression, où le nombre de pixels par centimètre détermine directement la netteté perçue.

• 1k : résolution standard, adaptée à la plupart des usages web. Temps de génération plus rapide.
• 2k : haute résolution, idéale pour l’impression ou les visuels nécessitant beaucoup de détails.

# Résolution standard pour le web
response_web = client.images.generate(
    model="grok-imagine-image",
    prompt="Icône d'application mobile style néon",
    resolution="1k",
    aspect_ratio="1:1"
)

# Haute résolution pour l'impression
response_print = client.images.generate(
    model="grok-imagine-image-quality",
    prompt="Affiche de concert style art déco avec typographie élégante",
    resolution="2k",
    aspect_ratio="3:4"
)

Formats de réponse

Le paramètre response_format détermine comment l’image vous est renvoyée :

URL temporaire (défaut)

response = client.images.generate(
    model="grok-imagine-image",
    prompt="Chat astronaute",
    response_format="url"
)
# response.data[0].url → URL temporaire à télécharger rapidement

Base64 JSON

import base64

response = client.images.generate(
    model="grok-imagine-image",
    prompt="Chat astronaute",
    response_format="b64_json"
)

image_bytes = base64.b64decode(response.data[0].b64_json)
with open("chat_astronaute.png", "wb") as f:
    f.write(image_bytes)

Le mot important est temporaire : l’URL retournée expire. Une application qui la stocke en base et l’affiche des semaines plus tard découvrira des images cassées, souvent bien après la mise en production. Deux options tiennent : télécharger l’image depuis l’URL immédiatement, ou demander directement le Base64 — dans les deux cas, l’image doit finir sur votre propre stockage.

Choisir la bonne combinaison

Pour chaque cas d’usage, voici les combinaisons recommandées :

• Post Instagram : 1:1, résolution 1k, modèle standard
• Story/Reel : 9:16, résolution 1k, modèle standard
• Bannière web : 16:9 ou 2:1, résolution 1k, modèle standard
• Affiche événement : 3:4, résolution 2k, modèle pro
• Illustration article : 16:9, résolution 2k, modèle pro

Points clés à retenir

• Plus de 10 ratios d’aspect disponibles, plus le mode auto
• Deux résolutions : 1k (rapide, web) et 2k (détaillé, impression)
• Deux formats de réponse : url (temporaire) et b64_json (persistant)
• Les types MIME retournés peuvent être PNG, JPEG ou WebP
• Adaptez le ratio au canal de diffusion de votre image