Endpoint /v1/images/generations: Premiers pas
Pe această pagină
Leçon achevé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 de 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érez votre 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 vous permet de créer des images à partir d’une description textuelle en utilisant les modèles Grok Imagine. Que vous souhaitiez produire des illustrations, des visuels marketing ou des prototypes créatifs, tout commence par cet endpoint.
Dans cette leçon, vous apprendrez à structurer une demande de génération d’image et à comprendre les paramètres fondamentaux.
Structure d’une requête de génération
Deux paramètres suffisent pour générer une image : le modèle et le prompt (l’instruction). Tous les autres possèdent des valeurs par défaut, ce qui vous permet d’obtenir un premier résultat en trois lignes. C’est d’ailleurs exactement ce que vous devriez faire avant de lire la suite, afin d’avoir une image sous les yeux pour associer chaque paramètre à son effet concret.
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 : il vous suffit de pointer le base_url vers https://api.x.ai/v1, de fournir votre clé xAI, et le reste de votre code demeure inchangé. Gardez bien à l’esprit 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 abordera ce point.
Paramètres de la requête
Voici les paramètres que vous pouvez inclure dans votre requête :
model: le modèle de génération à utiliser (grok-imagine-imageougrok-imagine-image-2.0, voir la 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 la 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. Parcourez-le par itération plutôt que de lire directement data[0], sinon votre code échouera le jour où vous définirez 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
Essayez de générer votre première image en adaptant le prompt à votre 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"},
)
Puncte cheie
- 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 modifiant le
base_url - Vous pouvez générer jusqu’à 10 images par requête
- Les résolutions disponibles sont
1k(par défaut) et2k