Grok Imagine Image 2.0 API
Essayez Grok Imagine Image 2.0 avant d integrer l API.
Testez la qualite de sortie, estimez la consommation de credits et generez des exemples avant l integration formelle.
Create image task
Fixed to grok-imagine-image-2.0Optional. Add 1-3 images to switch to editing mode. Each input image is billed once per request.

Connaissez vos couts de test avant d ajouter des credits.
La tarification suit une matrice simple resolution (1K/2K) x qualite (Low/Medium). Partez du cout d un echantillon et choisissez un budget de test.
First Test Cost
Text-to-Image - 1K - Low qualityOne 1K Low prompt-only image
About 333 tests with $10 in credits.
Start with the 1K Low tier for drafts, then switch to Medium or 2K for the final check. Input images add a per-image fee once per request.
Testing Budget Guide
Pick an amount based on how many tests you expect.Good for a first validation.
Good for prompt iteration.
Good before production integration.
Common Cost Examples
Estimated cost for one generated image. Multiply the output rate by n for multi-image requests; input image fees are charged once per request.
Model Pricing
| Item | Rule | Rate | Billing |
|---|---|---|---|
| 1K · Low | Fastest tier (~10s) for drafts and prompt iteration. | $0.030/image-25% 2.04 cr/image$0.040 prix officiel | Per output image |
| 1K · Medium (default) | Default tier with better detail; generation may take 10-75s. | $0.045/image-25% 3.06 cr/image$0.060 prix officiel | Per output image |
| 2K · Low | Higher resolution with the fast quality tier. | $0.045/image-25% 3.06 cr/image$0.060 prix officiel | Per output image |
| 2K · Medium | Highest tier for final quality checks. | $0.060/image-25% 4.08 cr/image$0.080 prix officiel | Per output image |
Optional Add-ons & Billing NotesInput image pricing and multi-image requests.
| Item | Rule | Rate | Billing |
|---|---|---|---|
| Input images | Applied to each input image in image_urls (max 3), charged once per request regardless of n. | $0.0075/image-25% 0.51 cr/image$0.010 prix officiel | Per input image |
| Multiple outputs (n) | n can be 1-10. The output rate is multiplied by n; failed tasks are not charged. | Output rate × n | Per request |
Generation et édition d’images avec Grok Imagine Image 2.0
Grok Imagine Image 2.0 utilise l’ID de modèle officiel grok-imagine-image-2.0 et prend en charge le texte-vers-image et l’édition avec 1-3 images de référence dans une seule route API, avec 13 ratios, une sortie 1K/2K et jusqu’à 10 images par requête.
Guides et comparatifs Grok Imagine Image 2.0
Capacités clés de génération et d’édition d’images de Grok Imagine Image 2.0

Créer un visuel commercial avec un seul prompt

Diriger une édition avec une image de référence

Composer à partir de plusieurs références
Quels workflows d’image pour l’API Grok Imagine Image 2.0
Générer des visuels marketing
Éditer avec des images d’entrée
Variantes en lot avec n
Contrôler le coût par palier
Positionnement des API d’image et choix du modèle
| Caractéristique | Grok Imagine Image 2.0 | Seedream 5.0 Pro | GPT Image |
|---|---|---|---|
| Prix de départ | ~$0.030 / image | Dès ~$0.034 / image | Par token ou par palier |
| Paliers de sortie | Low/Medium x 1K/2K | 1K / 2K | Paliers de qualité |
| Entrée de référence | Jusqu’à 3 images | Jusqu’à 10 images | Pris en charge |
| Images par requête | 1-10 | 1 | Selon le modèle |
| Idéal pour | Itération rapide, créations en lot, édition par référence | Publicités, créations produit, édition d’images | Workflows d’image OpenAI |
ID de modèle, images de référence et limites de sortie
ID de modèle officiel, deux modes d’image
L’ID du modèle est grok-imagine-image-2.0. Un prompt seul produit du texte-vers-image ; ajoutez 1-3 images d’entrée et le même ID bascule en mode édition, sans ID de modèle d’édition séparé.
Qualité et résolution indépendantes
quality (low/medium) contrôle l’effort et la vitesse ; resolution (1k/2k) contrôle les pixels de sortie. Les deux entrent dans la matrice de prix : les quatre combinaisons coûtent 1x / 1.5x / 1.5x / 2x le tarif de base.
Frais d’entrée facturés une fois
Chaque image d’entrée ajoute 0.25x le tarif de base par requête, quel que soit le nombre de sorties demandées avec n. Les tâches échouées ne sont pas facturées.
Pourquoi accéder à Grok Imagine Image 2.0 via l’API unifiée EvoLink
Coût en direct avant génération
Consultez le prix actuel et les crédits estimés avant l’envoi, selon la résolution, la qualité, le nombre de sorties et les images de référence.
API unifiée
Une clé API fonctionne pour Grok, Seedream, Nano Banana, GPT Image, la vidéo, l’audio et les LLM.
Solde unifié
Suivez les crédits, les dépenses et l’utilisation des modèles dans une seule console.
Suivi du statut des tâches
Voyez si une tâche d’image est soumise, en cours, terminée ou échouée.
Hébergement stable des résultats
Les images générées sont réhébergées sur le CDN EvoLink, les liens restent utilisables après expiration des liens upstream.
Famille de modèles Grok

Grok Imagine Video 1.5
Route vidéo xAI : texte-vers-vidéo, image-vers-vidéo et référence-vers-vidéo dans un modèle, durées de 1 à 15 s.
Voir
Grok Imagine Video
Route vidéo Grok Imagine de première génération pour les workflows texte-vers-vidéo et image-vers-vidéo.
Voir
Autres modèles d’image sur EvoLink

Seedream 5.0 Pro
Route d’image BytePlus avec paliers 1K/2K, jusqu’à 10 images de référence et édition par instruction.
Voir
Nano Banana 2
Modèle d’image Google pour une génération de haute qualité et des workflows créatifs flexibles.
Voir

Qwen Image Edit
Route d’édition d’images pour les transformations directes et les modifications créatives localisées.
VoirFAQ
Quel est l’ID de modèle officiel de l’API Grok Imagine Image 2.0 ?
L’ID officiel du modèle est grok-imagine-image-2.0. Le texte-vers-image et l’édition avec 1-3 images de référence utilisent le même ID ; il n’est pas nécessaire de choisir un modèle d’édition séparé.
Combien coûte Grok Imagine Image 2.0 ?
La tarification suit une matrice résolution × qualité : 1K Low correspond au tarif de base, 1K Medium et 2K Low à 1.5x, et 2K Medium à 2x. Le coût de sortie est multiplié par n, et chaque image d’entrée ajoute 0.25x le tarif de base une fois par requête.
Puis-je tester avant d’intégrer l’API ?
Oui. Utilisez le Playground pour tester la qualité, estimer les crédits et inspecter le JSON de requête avant l’intégration.
Quelle est la différence entre quality et résolution ?
quality (low/medium) contrôle l’effort de génération : low prend environ 10 s, medium de 10 à 75 s avec plus de détails. resolution (1k/2k) contrôle les pixels de sortie. Ce sont des paramètres indépendants qui influencent tous deux le prix.
Comment modifier des images ?
Passez 1-3 URLs d’images dans image_urls avec le prompt. Le modèle bascule automatiquement en mode édition. Avec plusieurs images, désignez chacune dans le prompt par <IMAGE_0>, <IMAGE_1>, <IMAGE_2>.
Puis-je générer plusieurs images avec n ?
Oui. n peut aller de 1 à 10 par requête. Le coût de sortie est multiplié par n, tandis que les frais d’images d’entrée ne sont facturés qu’une fois par requête.
Les images d’entrée sont-elles facturées ?
Oui. Chaque image d’entrée dans image_urls ajoute 0.25x le tarif de base, une fois par requête et indépendamment de n. Seules les URL http(s) publiques sont acceptées ; les envois en base64 sont rejetés.
Puis-je définir des dimensions personnalisées ?
Non. size accepte 13 formats prédéfinis ainsi que auto. Les valeurs WIDTHxHEIGHT personnalisées ne sont pas prises en charge ; la résolution se contrôle séparément avec le paramètre 1k/2k.
Que se passe-t-il en cas d’échec ?
Les tâches échouées ne sont pas facturées : le montant préautorisé est intégralement remboursé, y compris pour les rejets en amont, les blocages de modération et les expirations.
Où aller après avoir rechargé des crédits ?
Retournez au Playground pour d’autres tests, ou créez une clé API et utilisez /v1/images/generations avec le modèle grok-imagine-image-2.0.
API Reference
Select endpoint
Authentication
All APIs require Bearer Token authentication.
Authorization:
Bearer YOUR_API_KEY/v1/images/generationsGenerate Image
Grok Imagine Image 2.0 is xAI's image generation and editing model — text-to-image and image editing share the same model name. Omit image_urls for text-to-image; pass 1-3 reference images and it automatically switches to image editing, no model change needed.
Asynchronous processing mode, use the returned task ID to .
Generated image links are valid for 24 hours, please save them promptly.
Request Parameters
modelstringRequiredDefault: grok-imagine-image-2.0Image generation model name. Text-to-image and image editing share this model name; the mode switches automatically depending on whether image_urls is provided.
| Value | Description |
|---|---|
| grok-imagine-image-2.0 | Grok Imagine Image 2.0 model |
grok-imagine-image-2.0promptstringRequiredPrompt describing the image you want to generate, or how to edit the reference images you provide.
Notes
- Multi-image reference syntax: use <IMAGE_0>, <IMAGE_1>, <IMAGE_2> in the prompt to refer to the 1st, 2nd and 3rd reference image respectively
- Indexes start at 0 and map one-to-one to the order of the image_urls array
- Example: Place the person from <IMAGE_0> into the scene of <IMAGE_1>
Cyberpunk Tokyo street at night, neon lights reflecting on the wet pavementimage_urlsarrayOptionalReference image URL list for image-to-image and image editing functions.
Notes
- Number of input images per request: 0~3 (omitted = text-to-image, 1~3 = image editing)
- Only publicly accessible http / https image URLs are supported; base64 and data URLs are not supported
- Supported file formats: .jpeg, .jpg, .png, .webp
- Image URLs must be directly accessible by the server, or directly download when accessed (typically ending with image file extensions such as .png, .jpg)
- In image editing scenarios the reference images incur an additional charge, counted once per request and not multiplied by n
["https://example.com/person.png", "https://example.com/scene.png"]sizestringOptionalDefault: autoAspect ratio of the generated image, defaults to auto.
| Value | Description |
|---|---|
| auto | The model decides the ratio itself; omitting this parameter is equivalent to auto (output is usually portrait) |
| 1:1 | Square |
| 4:3 / 3:4 | Classic landscape / portrait |
| 3:2 / 2:3 | Standard landscape / portrait |
| 16:9 / 9:16 | Widescreen / mobile portrait |
| 2:1 / 1:2 | Ultra-wide / ultra-tall |
| 19.5:9 / 9:19.5 | Full-screen phone landscape / portrait |
| 20:9 / 9:20 | Ultra-wide landscape / portrait |
Notes
- Values outside the 13 supported ratios are not supported; custom WIDTHxHEIGHT pixel sizes are not accepted
16:9resolutionstringOptionalDefault: 1KPixel tier of the output image, defaults to 1K; supports the 1K and 2K tiers.
| Value | Description |
|---|---|
| 1K | Standard resolution (default) |
| 2K | Higher resolution |
Notes
- This model does not support 4K
- Values are case-insensitive
1KqualitystringOptionalDefault: mediumGeneration quality tier, controls how deeply the model thinks, defaults to medium.
| Value | Description |
|---|---|
| low | Faster output, lower cost |
| medium | Better image quality and detail |
Notes
- This model only supports the low / medium tiers; other values such as high are not supported
- quality (quality tier) and resolution (pixel tier) are independent and can be combined freely
- Values are case-insensitive
mediumnintegerOptionalDefault: 1Number of images to generate, range 1~10, defaults to 1.
| Value | Description |
|---|---|
| 1-10 | Any integer between 1 and 10 |
Notes
- Each image is billed independently, cost grows linearly with n
- The additional charge for reference images is counted once per request and is not multiplied by n
- When the task completes, results returns n independent image links
1callback_urlstringOptionalHTTPS callback address after task completion.
Notes
- Triggered when task is completed, failed, or cancelled; sent after billing confirmation
- HTTPS only; callbacks to internal IP addresses are prohibited; max length 2048 chars
- Timeout: 10s, max 3 retries on failure (after 1s / 2s / 4s)
- Callback body format is consistent with the task query API response; a 2xx response is considered successful, other status codes trigger a retry
https://your-domain.com/webhooks/image-task-completed