API Grok Image

En un coup d’œil

L'API Grok Image fait tourner Grok Image Quality et 2 autres variantes via Mage sur POST https://api.mage.space/v1/grok_image/generate. Une requête avec les réglages par défaut coûte 75 Gems (environ 0,075 $), sans abonnement. Grok Image prend en charge les personnages et références enregistrés via @handle dans le prompt.

• Image

  Sortie

• 3

  Variantes

• 75

  Gems par image, par défaut

• $0.075

  Environ, en USD

Présentation

Ce que fait l'API Grok Image

Le modèle d'images Grok Imagine de xAI, en trois niveaux de qualité. Il génère ou retouche à partir de 3 images de référence maximum en préservant les détails de la source. Le filtre de sécurité de xAI s'applique.

Les modèles d'images Grok Imagine de xAI, en trois niveaux de qualité, pour générer et retoucher à partir d'images de référence. 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.

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-quality"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// 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-quality',
});

console.log(request.result.url);

# 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-quality",
})

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.

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.

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.

Autres modèles d'image

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

FAQ

Questions fréquentes

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.

À voir aussi

• API de génération d'images IA
• Référence de l'API Grok Image
• Playground Grok Image
• Tous les modèles de l'API
• Serveur MCP Mage