Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Endpoint /v1/images/generations : Premiers pas

Lektion 1 av 14 Uppdaterad 3 november 2026 Nybörjare
På denna sida
  1. Génère ta première image avec l’API Grok
  2. Structure d’une requête de génération
  3. Paramètres de la requête
  4. Format de la réponse
  5. Mise en pratique
  6. Viktiga punkter

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 de 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
Nombre max d'images par requête
2k
Résolution maximale

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. 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="A Breton lighthouse under a starry sky, watercolor style"
)

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="An enchanted forest with fireflies, digital art style",
    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 directement 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="Minimalist chart showing startup growth, "
           "blue and white colors, dark background, flat design style",
    extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)

Viktiga punkter

  • 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