Passer au contenu

API Mage · Modèle d'image

API Grok Image

Grok Imagine, en deux versions

POST https://api.mage.space/v1/grok_image/generate

En 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_idNomPar défaut
grok-imagine-imageGrok Image
grok-imagine-image-2.0Grok Image 2.0Oui

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.

ChampValeurs
aspect_ratio1: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
resolution1k, 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.

ChampRôle
imageL'image de référence.
additional_imagesImages de référence supplémentaires.

Autres modèles d'image

Autres API de génération d'images sur Mage

  • Image · à partir de 37 Gems

    API Guava

    Un photoréalisme digne d'une vraie photo

  • Image · à partir de 20 Gems

    API HiDream

    Rapide et polyvalent, avec prompts négatifs

  • Image · à partir de 20 Gems

    Krea 2 API

    Une esthétique superbe en quelques secondes

  • Image · à partir de 42 Gems

    API Mango

    Notre famille d'images phare

  • Image · à partir de 15 Gems

    API MiniMax H3 Image

    Images natives de 16 mégapixels, poids ouverts

  • Image · à partir de 25 Gems

    API MOSS-Image

    Prompts longs et texte bilingue, poids ouverts

FAQ

Questions fréquentes

Combien coûte l'API Grok Image ?
Une requête Grok Image avec les paramètres par défaut (Grok Image 2.0) coûte 90 Gems, soit environ 0,09 $. Les autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; celle que bloque la politique de contenu de Mage ne l'est pas.
Quel est le endpoint de l'API Grok Image ?
POST https://api.mage.space/v1/grok_image/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles Grok Image puis-je appeler ?
grok-imagine-image (Grok Image), grok-imagine-image-2.0 (Grok Image 2.0). Le modèle par défaut est Grok Image 2.0.
Grok Image prend-il en charge les images de référence ou les personnages ?
Grok Image accepte image, additional_images. Grok Image prend en charge les personnages et références enregistrés via @handle dans le prompt.
Puis-je utiliser Grok Image depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor, puis demande Grok Image par son nom. Ton assistant lit ses options avec get_model et t'indique le prix avant de générer.
Combien de temps les résultats de Grok Image sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.

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.

CharactersCommunauté