API Mage · Modèle d'image
API Grok Image
Grok Imagine, en deux versions
POST https://api.mage.space/v1/grok_image/generateEn un coup d’œil
L'API Grok Image exécute Grok Image 2.0 et une autre variante via Mage sur POST https://api.mage.space/v1/grok_image/generate. Une requête avec les paramètres par défaut coûte 90 Gems (environ 0,09 $), sans abonnement. Grok Image accepte les personnages enregistrés et les références via @handle dans le prompt.
- ImageSortie
- 2Variantes
- 90Gems par image, par défaut
- $0.09Environ, en USD
Présentation
Ce que fait l'API Grok Image
Le modèle d'image Grok Imagine de xAI en deux versions. Il génère ou modifie des images à partir de 3 images de référence maximum, tout en préservant les détails de la source. Le filtre de sécurité de xAI s'applique.
Les modèles d'image Grok Imagine de xAI en deux versions, pour générer des images et les modifier à partir d'images de référence : Grok Image 2.0 (`grok-imagine-image-2.0`), le modèle par défaut, et Grok Image (`grok-imagine-image`) pour des brouillons économiques. xAI a retiré Grok Image Quality (`grok-imagine-image-quality`) le 2 novembre 2026, et toute requête qui le mentionne est refusée. Le filtre de sécurité de xAI s'applique.
Il accepte image et additional_images en entrée.
Démarrage rapide
Appeler l'API Grok Image
Définis MAGE_API_KEY, envoie ta requête à /grok_image/generate, puis interroge status_url jusqu'à ce que la requête soit terminée.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_image/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('grok_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '1:1',
model_id: 'grok-imagine-image-2.0',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("grok_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0",
})
print(request["result"]["url"])Modèles
Valeurs model_id de Grok Image
Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.
| model_id | Nom | Par défaut |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Oui |
Options
Paramètres de Grok Image
Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.
| Champ | Valeurs |
|---|---|
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20 |
| resolution | 1k, 2k |
Entrées
Médias acceptés en entrée par Grok Image
Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.
| Champ | Rôle |
|---|---|
| image | L'image de référence. |
| additional_images | Images de référence supplémentaires. |
Autres modèles d'image
Autres API de génération d'images sur Mage
API Guava
Un photoréalisme digne d'une vraie photo
API HiDream
Rapide et polyvalent, avec prompts négatifs
Krea 2 API
Une esthétique superbe en quelques secondes
API Mango
Notre famille d'images phare
API MiniMax H3 Image
Images natives de 16 mégapixels, poids ouverts
API MOSS-Image
Prompts longs et texte bilingue, poids ouverts
FAQ
Questions fréquentes
Combien coûte l'API Grok Image ?
Quel est le endpoint de l'API Grok Image ?
Quels modèles Grok Image puis-je appeler ?
Grok Image prend-il en charge les images de référence ou les personnages ?
Puis-je utiliser Grok Image depuis Claude ou ChatGPT ?
Combien de temps les résultats de Grok Image sont-ils conservés ?
Lance-toi avec Mage
Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.