API Grok Video

En un coup d’œil

L'API Grok Video exécute Grok Video via Mage à l'adresse POST https://api.mage.space/v1/grok_video/generate. Une requête avec les réglages par défaut coûte 375 Gems (environ 0,375 $), sans abonnement. Grok Video utilise les personnages et références enregistrés via @handle dans le prompt.

• Vidéo

  Sortie

• 1

  Variante

• 375

  Gems par clip, par défaut

• $0.375

  Environ, en USD

Présentation

Ce que fait l'API Grok Video

Grok Imagine de xAI pour la vidéo, à partir d'un texte, de jusqu'à 5 références ou d'un court clip source. De 1 à 15 secondes, jusqu'en 720p. Le filtre de sécurité de xAI s'applique.

Grok Imagine de xAI pour la vidéo, à partir d'un texte, d'images de référence ou d'une vidéo source à modifier. Le filtre de sécurité de xAI s'applique.

Elle accepte image, additional_images et video en entrée.

Démarrage rapide

Appeler l'API Grok Video

Définis MAGE_API_KEY, envoie ta requête à /grok_video/generate, puis interroge status_url jusqu'à la fin de la requête.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_video/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "5",
  "model_id": "grok-imagine-video"
}' | 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_video', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'grok-imagine-video',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("grok_video", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "5",
    "model_id": "grok-imagine-video",
})

print(request["result"]["url"])

Modèles

Valeurs model_id de Grok Video

Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.

Options

Paramètres de Grok Video

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 par Grok Video

Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.

Règles

Ce que l'API Grok Video impose

• Une vidéo source ne doit pas dépasser 8,7 secondes et ne peut pas être combinée avec des images de référence.
• Jusqu'à 5 images de référence, ce qui limite le clip à 10 secondes.

Plus de modèles vidéo

Autres API de génération vidéo 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 de vidéos IA
• Référence de l'API Grok Video
• Playground Grok Video
• Tous les modèles de l'API
• Serveur MCP Mage