Salt la conținutul principal
Română— Alege o limbă
Meniu

Endpoint /v1/images/generations: Premiers pas

Lecția 1 din 14 Actualizată 3 noiembrie 2026 Începător
Pe această pagină
  1. Générez votre 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. Puncte cheie

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_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érez votre 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 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.

1
Endpoint de génération
2
Modèles disponibles
10
Nombre maximal 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 (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-image ou grok-imagine-image-2.0, voir la 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 la 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. 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 (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

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 : model et prompt
  • 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) et 2k