Endpoint /v1/images/generations: Premiers pas
In questa pagina
Leçon terminée le 3 novembre 2026 sur la base de la page Génération d’images et de la référence de l’API Images xAI : valeurs par défaut (
aspect_ratiodéfini surauto,resolutionsur1k), paramètrequalitypour Imagine 2.0, et JPEG comme format par défaut. Sources : Génération d’images · API Images.
Génère ta première image avec l’API Grok
L’API xAI propose un endpoint dédié à la génération d’images : POST /v1/images/generations. Cet endpoint te permet de créer des images à partir d’une description textuelle en utilisant les modèles Grok Imagine. Que tu souhaites produire des illustrations, des visuels marketing ou des prototypes créatifs, tout commence par cet endpoint.
Dans cette leçon, tu apprendras à structurer une demande de génération d’image et à comprendre les paramètres fondamentaux.
Structure d’une demande de génération
Deux paramètres suffisent pour générer une image : le modèle et le prompt. Tous les autres ont des valeurs par défaut, ce qui te permet d’obtenir un premier résultat en trois lignes. C’est exactement ce que tu dois faire avant de lire la suite, afin d’avoir une image sous les yeux pour associer chaque paramètre à son effet.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.images.generate(
model="grok-imagine-image",
prompt="Un phare breton sous un ciel étoilé, style aquarelle"
)
image_url = response.data[0].url
print(image_url)
L’API xAI est compatible avec le SDK OpenAI pour la génération d’images : tu pointes base_url vers https://api.x.ai/v1, fournis ta clé xAI, et le reste de ton code reste inchangé. Garde bien en tête la portée de cette compatibilité : elle s’applique à la génération, mais pas à l’édition, qui attend un format différent. La leçon 5 aborde ce point.
Paramètres de la requête
Voici les paramètres que tu peux inclure dans ta requête :
model: le modèle de génération à utiliser (grok-imagine-imageougrok-imagine-image-2.0, voir leçon 2)prompt: la description textuelle de l’image souhaitéen: le nombre d’images à générer (de 1 à 10, par défaut : 1)aspect_ratio: le format de l’image (autopar défaut : le modèle choisit en fonction du prompt)resolution: la résolution (1kpar défaut, ou2k)quality:low,mediumouauto(par défaut) sur Imagine 2.0, voir leçon 12response_format:url(par défaut) oub64_jsonpour recevoir l’image en Base64
Exemple avec tous les paramètres
response = client.images.generate(
model="grok-imagine-image",
prompt="Une forêt enchantée avec des lucioles, style art numérique",
n=2,
response_format="url",
extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)
for image in response.data:
print(image.url)
Format de la réponse
La réponse est toujours un tableau, même pour une seule image : itère dessus plutôt que de lire data[0], sinon ton code plantera le jour où tu définiras n=4. Chaque objet contient :
url: l’URL temporaire de l’image (siresponse_formatesturl)b64_json: les données Base64 de l’image (siresponse_formatestb64_json)
Le type MIME retourné peut être image/png, image/jpeg ou image/webp ; il vaut par défaut image/jpeg, sauf si un réglage de qualité produit du PNG.
Mise en pratique
Essaie de générer ta première image en adaptant le prompt à ton contexte professionnel. Par exemple, pour un visuel de présentation :
response = client.images.generate(
model="grok-imagine-image",
prompt="Graphique minimaliste montrant la croissance d'une startup, "
"couleurs bleu et blanc, fond sombre, style design plat",
extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)
Punti chiave
- L’endpoint de génération est
POST /v1/images/generations - Deux paramètres suffisent pour commencer :
modeletprompt - L’API est compatible avec le SDK Python OpenAI en changeant le
base_url - Tu peux générer jusqu’à 10 images par requête
- Les résolutions disponibles sont
1k(par défaut) et2k