Ratios, résolutions et formats de sortie — Générer et éditer des images avec Grok

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 paramètre aspect_ratio contrôle les proportions de l’image. Voici les principaux ratios supportés :

Ratio	Orientation	Usage typique
1:1	Carré	Profils, icônes, Instagram
16:9	Paysage large	Présentations, bannières, vidéo
9:16	Portrait vertical	Stories, Reels, TikTok
4:3	Paysage classique	Photos traditionnelles, documents
3:4	Portrait	Affiches, couvertures de livre
3:2 / 2:3	Photo standard	Tirages photo, cartes postales
2:1 / 1:2	Ultra large / ultra vertical	Bannières web, panoramas
auto	Automatique	Le modèle choisit le ratio optimal

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

Le paramètre resolution accepte deux valeurs :

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-pro",
    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 format Base64 est utile lorsque vous souhaitez stocker l’image immédiatement sans dépendre d’une URL temporaire.

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