Grok Imagine API : guide Python et 3 modèles comparés

L'API Grok Imagine est l'API d'images et de vidéos de xAI, et vous pouvez y appeler trois modèles d'image : grok-imagine-image, grok-imagine-image-quality et grok-imagine-image-2.0. Le 18 octobre 2026, nous avons passé les mêmes quatre prompts dans les trois, et Grok Imagine 2.0 a gagné trois des quatre tests.

Ci-dessous : quel modèle choisir, un script Python qui tourne tel quel, ce que xAI facture par image et les points à surveiller.

La réponse courte

• Utilisez Grok Imagine 2.0 (grok-imagine-image-2.0) par défaut. Il a donné la meilleure typographie d'affiche, la meilleure photo produit et la meilleure photo de nos tests, et xAI l'affiche à partir de 0,04 USD par image.
• Pour des brouillons bon marché, gardez le grok-imagine-image d'origine : 0,02 USD par image chez xAI, et il a aussi réussi le texte de l'affiche.
• Laissez tomber grok-imagine-image-quality : xAI le retire le 2 novembre 2026, et il a ajouté une adresse inventée à notre affiche.
• Toutes les images sont revenues en 7 à 18 secondes.

Qu'est-ce que l'API Grok Imagine ?

C'est l'API d'images et de vidéos de xAI, ouverte le 28 janvier 2026 (xAI). Image 2.0 est arrivé le 7 août 2026, et xAI dit qu'il est deuxième mondial en génération comme en retouche d'images (xAI).

Les trois sont sur OmniaKey : Grok Imagine, Grok Imagine Quality et Grok Imagine 2.0. OmniaKey vend l'accès API à ces modèles, donc nos tests sont passés par lui ; tous les prix ici sont ceux de xAI.

Quel modèle Grok Imagine choisir ?

Grok Imagine 2.0, sauf si vous ne voulez que des brouillons bon marché. Nous avons donné à chaque modèle les mêmes quatre prompts une fois, sans réglage de taille ni de format, et jugé les images en taille réelle.

Test 1 : le texte de l'affiche

Prompt :

A minimalist poster for a neighborhood coffee shop opening. Large bold headline text "GRAND OPENING", smaller text below "Saturday 9 AM", a simple line drawing of a coffee cup, cream background, dark brown ink.

Les trois ont écrit correctement les deux lignes (l'affiche ci-dessus). Grok Imagine 2.0 avait la mise en page la plus travaillée, avec de fins filets autour de la date. Quality a ajouté une ligne que personne n'avait demandée :

Verdict : 2.0 pour le rendu, l'original si seul le texte doit être juste. Pour l'impression, évitez Quality : un texte inventé est la dernière chose que vous voulez sur un tract.

Test 2 : une photo réaliste

Prompt :

A realistic photo of an elderly fisherman mending a blue net on a wooden dock at sunrise, soft golden light, gulls in the background, shallow depth of field.

• Grok Imagine : une belle lumière dorée et une scène crédible, mais tout le ponton est net.
• Quality : le sujet et le décor sont bons, mais le pêcheur est petit dans le cadre et le détail plus doux.
• Grok Imagine 2.0 : un gros plan avec un arrière-plan flou, le seul à avoir vraiment fait la « faible profondeur de champ ».

Verdict : 2.0.

Test 3 : une photo produit

Prompt :

Studio product photo of a matte black wireless earbud case, lid open, both earbuds inside, on a pure white background, soft shadow, sharp focus, no text, no logo.

Les trois ont respecté chaque détail : couvercle ouvert, les deux écouteurs, fond blanc, pas de logo. L'original laissait le boîtier petit dans le cadre, et Quality l'a photographié de biais. Grok Imagine 2.0 a rempli le cadre d'un détail net, prêt pour une fiche boutique.

Verdict : 2.0.

Test 4 : compter les objets

Prompt :

Top-down photo of a wooden table with exactly three red apples on the left and exactly two green pears on the right, nothing else on the table.

Les trois ont placé exactement trois pommes à gauche et deux poires à droite, sans rien d'autre sur la table. L'original a montré les poires debout plutôt que vues de dessus, et celles de 2.0 sont sorties plus jaunes que vertes.

Verdict : match nul sur le comptage ; Quality avait la vue de dessus la plus propre.

Comment l'appeler depuis Python ?

Trois étapes : créer la tâche, la vérifier jusqu'à la fin, puis télécharger l'image. Mettez votre clé dans une variable d'environnement et lancez :

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Créez la tâche. Réutilisez la même Idempotency-Key seulement pour rejouer cette requête précise.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "grok-imagine-image-2.0",
        "type": "image",
        "operation": "generate",
        "input": {"prompt": "A flat illustration of a red bicycle leaning on a yellow wall, morning light"},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Interrogez le statut jusqu'à la fin de la tâche.
while task["status"] in ("queued", "processing"):
    time.sleep(2)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Téléchargez tout de suite : l'URL signée expire vite.
asset = task["assets"][0]
with open("bicycle.jpg", "wb") as f:
    f.write(requests.get(asset["url"], timeout=60).content)
print("saved bicycle.jpg", asset["mime_type"], asset["byte_size"], "bytes")

Quand nous l'avons lancé le 18 octobre 2026, il a affiché ceci et enregistré un JPEG de 1248 × 832 16 secondes après le départ :

task: task_LBCu6Lr8hyD4RH25JfiOixJHPHi3Cd0o queued
saved bicycle.jpg image/jpeg 267732 bytes

Pour essayer un autre modèle, changez seulement la valeur de model.

Combien coûte l'API Grok Imagine ?

xAI facture à l'image, et le prix dépend du modèle, de la résolution et, pour 2.0, du niveau de qualité. Voici les tarifs de xAI sur sa page de prix, vérifiés le 18 octobre 2026 :

2.0 utilise la qualité basse pour les nouvelles images sauf demande contraire, donc une image 1K coûte 0,04 USD chez xAI. Sur l'API de xAI, une requête qui enfreint ses règles d'usage est facturée quand même. Avec OmniaKey, vous payez un prix fixe par image (les tarifs actuels sont sur les pages des modèles) et une tâche échouée est remboursée.

À quoi faut-il faire attention ?

• Pas de retouche via OmniaKey. L'API de xAI permet à 2.0 de retoucher des images avec jusqu'à cinq images de référence, mais via OmniaKey, Grok ne fait que générer de nouvelles images. Pour retoucher, prenez un modèle qui le permet, par exemple Nano Banana 2.1.
• C'est le modèle qui choisit la forme. Sans réglage de format, Grok a choisi le portrait pour l'affiche et le paysage pour les scènes, toujours autour d'un mégapixel (de 832 × 1248 à 1280 × 720).
• Quality disparaît le 2 novembre. Ensuite, xAI traite les requêtes grok-imagine-image-quality avec 2.0 en qualité basse, alors changez maintenant.
• Réessayez une fois sur une erreur 400. Une de nos 14 tâches a échoué avec un 400 et a été remboursée ; la même requête relancée a fonctionné.

Conclusion

Pour la plupart des usages, appelez grok-imagine-image-2.0 : il a gagné trois de nos quatre tests et coûte 0,04 USD par image 1K chez xAI. Prenez le modèle d'origine quand il vous faut beaucoup de brouillons bon marché, et quittez Quality avant le 2 novembre.

Questions fréquentes

L'API Grok Imagine est-elle gratuite ?

Non. xAI affiche un prix par image pour chaque modèle d'image Grok, à partir de 0,02 USD pour le modèle d'origine.

Grok Imagine peut-il faire des vidéos via l'API ?

Oui. xAI facture ses modèles vidéo à la seconde, par exemple 0,08 USD par seconde en 480p pour Grok Imagine Video 1.5. Sur OmniaKey, voir Grok Imagine Video 1.5.

Quelle taille d'image obtient-on ?

Environ un mégapixel par défaut. Le guide de xAI indique 1K par défaut et 2K en option, et le modèle choisit le format si vous n'en imposez pas.

Que devient grok-imagine-image-quality après le 2 novembre ?

xAI répond toujours, mais avec Grok Imagine 2.0 en qualité basse et au prix de 2.0. Le grok-imagine-image d'origine n'est pas concerné.