Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Endpoint /v1/images/generations: Premiers pas

Lezione 1 di 14 Aggiornata il 3 novembre 2026 Principiante
In questa pagina
  1. Génère ta première image avec l’API Grok
  2. Structure d’une demande de génération
  3. Paramètres de la requête
  4. Format de la réponse
  5. Mise en pratique
  6. Punti chiave

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_ratio défini sur auto, resolution sur 1k), paramètre quality pour 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

Image générée par 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.

1
Endpoint de génération
2
Modèles disponibles
10
Max d'images par requête
2k
Résolution maximale

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-image ou grok-imagine-image-2.0, voir leçon 2)
  • prompt : la description textuelle de l’image souhaitée
  • n : le nombre d’images à générer (de 1 à 10, par défaut : 1)
  • aspect_ratio : le format de l’image (auto par défaut : le modèle choisit en fonction du prompt)
  • resolution : la résolution (1k par défaut, ou 2k)
  • quality : low, medium ou auto (par défaut) sur Imagine 2.0, voir leçon 12
  • response_format : url (par défaut) ou b64_json pour 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 (si response_format est url)
  • b64_json : les données Base64 de l’image (si response_format est b64_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 : model et prompt
  • 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) et 2k