How do I generate a video using grok-imagine-video API?

Comment générer une vidéo à l’aide de l’API grok-imagine-video ?

You send a POST request with model 'grok-imagine-video' including a text prompt and optional image/video source; it returns a task ID, then poll this ID until the video status is 'done'.

Vous envoyez une requête POST avec le modèle 'grok-imagine-video', incluant une invite textuelle et une source image/vidéo facultative ; elle renvoie un ID de tâche, puis vous interrogez cet ID jusqu’à ce que le statut de la vidéo soit 'done'.

What input formats does grok-imagine-video accept?

Quels formats d’entrée grok-imagine-video accepte-t-il ?

It accepts a natural language prompt and optional image URLs (or base64 images) for animation; for editing, a video URL is provided.

Il accepte une invite en langage naturel et des URL d’images facultatives (ou des images en base64) pour l’animation ; pour l’édition, une URL de vidéo est fournie.

What are the maximum video duration and resolution options?

Quelles sont la durée vidéo maximale et les options de résolution ?

The model supports video generation up to 15 seconds and resolutions up to 720p with configurable aspect ratios like 16:9 or 1:1.

Le modèle prend en charge la génération de vidéos jusqu’à 15 secondes et des résolutions jusqu’à 720p, avec des formats d’image configurables comme 16:9 ou 1:1.

Can I animate a still image into a video with this model?

Puis-je animer une image fixe en vidéo avec ce modèle ?

Yes, you can animate a still image into motion based on your prompt, using image URLs or encoded images in the request.

Oui, vous pouvez animer une image fixe pour la mettre en mouvement en fonction de votre invite, en utilisant des URL d’images ou des images encodées dans la requête.

Does grok-imagine-video support editing existing videos?

grok-imagine-video prend-il en charge l’édition de vidéos existantes ?

Yes — provide the source video URL and your edit instructions; the output keeps the original video’s duration and resolution.

Oui — fournissez l’URL de la vidéo source et vos instructions de modification ; la sortie conserve la durée et la résolution de la vidéo d’origine.

How does moderation work in grok-imagine-video outputs?

Comment fonctionne la modération dans les sorties de grok-imagine-video ?

Generated videos are subject to content moderation; flagged content may be filtered or blocked during generation.

Les vidéos générées sont soumises à une modération du contenu ; le contenu signalé peut être filtré ou bloqué pendant la génération.

Is the video generation asynchronous?

La génération de vidéo est-elle asynchrone ?

Yes, the API returns a request ID which you poll to check when the video is ready for download.

Oui, l’API renvoie un ID de requête que vous interrogez pour vérifier quand la vidéo est prête à être téléchargée.

How should I handle expired video URLs?

Comment dois-je gérer les URL de vidéos expirées ?

Downloaded videos should be saved quickly; temporary URLs may expire and become inaccessible after generation.

Les vidéos téléchargées doivent être enregistrées rapidement ; les URL temporaires peuvent expirer et devenir inaccessibles après la génération.

API Grok Imagine Video Abordable | image-to-video

📘 Spécifications techniques de Grok Imagine Video

Spécification	Détails
ID du modèle	grok-imagine-video
Fournisseur	xAI
Type	IA de génération et d’édition vidéo
Types d’entrée	Texte (prompt) ; image ou vidéo facultative Prompts textuels (langage naturel) ; image facultative (image→vidéo) ; option vidéo_url pour éditer des clips existants. Les durées max des vidéos à éditer varient selon l’endpoint — signalé ~8.7s pour certains flux d’édition.
Types de sortie	Vidéo .mp4 via URL temporaire
Durée (génération)	1–15 secondes
Résolution	480p, 720p (configurable)
Rapports d’aspect	1:1, 16:9, 9:16
Prise en charge de l’édition	Oui — anime et modifie des vidéos jusqu’à 8.7s
Modération	Modération de contenu incluse
Tarification	Facturation à la seconde, variable selon la résolution

🚀 Qu’est-ce que Grok Imagine Video ?

Grok Imagine Video est le modèle avancé d’IA de génération et d’édition vidéo de xAI, exposé via CometAPI. Il permet aux développeurs de générer de courtes vidéos personnalisées à partir de prompts en langage naturel et, en option, d’animer des images fixes ou d’éditer des clips existants. Le modèle prend en charge la durée, la résolution et le rapport d’aspect configurables, avec une modération de contenu intégrée pour garantir la conformité aux politiques.

🧠 Fonctionnalités principales (ce qui différencie Grok Imagine)

Audio natif + synchronisation labiale : génère un audio d’ambiance synchronisé, des effets et de courts segments de parole/narration avec une synchronisation labiale approximative.
Image→Vidéo / édition par prompt : anime une image fixe ou édite des séquences existantes via des prompts textuels (supprimer/remplacer des objets, réajuster le timing, restyler).
Itération rapide et faible latence : conçu pour des boucles de retour rapides adaptées aux workflows créatifs et au prototypage produit.
API de production : Imagine API expose des endpoints programmatiques pour la génération par lots, l’intégration dans des pipelines d’édition et des contrôles d’entreprise.
Multiples « modes » / styles : modes orientés utilisateur (exemples signalés : Normal / Fun / Spicy ou préréglages similaires) pour orienter la sortie en termes de style ou de permissivité (note : le mode « Spicy » a historiquement activé du NSFW).

Modèle (entreprise)	Résolution max (publique)	Durée max du clip (publique)	Audio natif ?	Atouts	Limites
Grok Imagine (xAI)	720p	6–15s	Oui	Itération rapide, bon coût/latence, édition intégrée, audio natif	Limitation à 720p ; questions de modération ; fidélité au réel variable
Sora (OpenAI)	720p–1080p (selon l’offre)	court (6–15s)	Oui	Haute fidélité visuelle ; forte intégration avec l’écosystème OpenAI	Plus cher ; modération/contrôles contraints
Veo (Google DeepMind)	Jusqu’à 1080p+	court (variable)	Oui	Fort photoréalisme, mouvement stable	Coût plus élevé ; moins d’expérimentation publique
Runway Gen-4.5	1080p+	court (variable)	Oui	Adoption par l’industrie pour les workflows créatifs, haute fidélité	Plus coûteux ; axé sur l’outillage créatif
Vidu / Kling / Pika (spécialistes)	jusqu’à 1080p	court (variable)	Mixte	Certaines offrent des fonctions de niche (Smart Cuts, enchaînement multi-plans)	Support audio variable ; maturité API différente

⚠️ Limitations

La durée maximale d’une vidéo est limitée à 15 secondes.
L’édition conserve la durée de la vidéo d’entrée (≤ 8.7s).
Les URL générées sont éphémères — téléchargez rapidement.

Comment accéder à et intégrer Grok Imagine Video

Étape 1 : Inscrivez-vous pour obtenir une clé API

Connectez-vous à cometapi.com. Si vous n’êtes pas encore utilisateur, veuillez d’abord vous enregistrer. Connectez-vous à votre console CometAPI. Obtenez la clé d’accès (API key) de l’interface. Cliquez sur « Add Token » dans la section API token du centre personnel, obtenez la clé de jeton : sk-xxxxx et soumettez.

Étape 2 : Envoyez des requêtes vers l’API `Grok Imagine Video`

Sélectionnez l’endpoint « grok-imagine-video » pour envoyer la requête API et définissez le corps de la requête. La méthode et le corps de la requête sont disponibles dans la documentation API de notre site. Notre site propose également un test Apifox pour votre commodité. Où l’appeler : GROK Génération vidéo et Édition vidéo.

Étape 3 : Envoyez des requêtes vers l’API `Grok Imagine Video`

Saisissez du texte ou téléchargez une image (vous pouvez fournir une image source à animer). L’API Grok Imagine analyse votre entrée et prépare le contenu pour l’URL. Les conversions texte-vers-vidéo et image-vers-vidéo sont prises en charge.

L’image source peut être fournie sous forme de :

Une URL publique pointant vers une image
Un URI de données encodé en base64 (p. ex., data:image/jpeg;base64,<YOUR_BASE64_IMAGE>)

Étape 4 : Récupérez et vérifiez les résultats

Traitez la réponse de l’API pour obtenir le résultat généré. Après traitement, l’API répond avec le statut de la tâche et les données de sortie. Un request_id est renvoyé immédiatement après soumission ; utilisez le point de terminaison GET pour vérifier le statut et récupérer la vidéo générée. L’édition vidéo est asynchrone ; vous devrez peut-être interroger ce point de terminaison plusieurs fois jusqu’à l’achèvement de la tâche. Veuillez télécharger rapidement.

Tarification pour Grok Imagine Video

Découvrez des tarifs compétitifs pour Grok Imagine Video, conçus pour s'adapter à différents budgets et besoins d'utilisation. Nos formules flexibles garantissent que vous ne payez que ce que vous utilisez, ce qui facilite l'adaptation à mesure que vos besoins évoluent. Découvrez comment Grok Imagine Video peut améliorer vos projets tout en maîtrisant les coûts.

Pricing Overview

Category	Item	Price
Input Pricing	Text	N/A (Free)
	Image	$0.0016
	Video per second	$0.008
Output Pricing	480p	$0.04
(Per second by resolution)	720p	$0.056

Note: When generating video via API, you are charged per second. You will also be charged when using video or images as input.

Exemple de code et API pour Grok Imagine Video

Accédez à des exemples de code complets et aux ressources API pour Grok Imagine Video afin de simplifier votre processus d'intégration. Notre documentation détaillée fournit des instructions étape par étape pour vous aider à exploiter tout le potentiel de Grok Imagine Video dans vos projets.

Python
JavaScript
Curl

import os
import time
import requests

# Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/grok/v1"

headers = {
    "Authorization": f"Bearer {COMETAPI_KEY}",
    "Content-Type": "application/json",
}

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
print("Step 1: Creating video generation task...")

create_payload = {
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p",
}

create_response = requests.post(
    f"{BASE_URL}/videos/generations", headers=headers, json=create_payload
)

create_result = create_response.json()
print(f"Create response: {create_result}")

# Extract task ID from the response
task_id = create_result.get("request_id") or create_result.get("id")
if not task_id:
    print("Error: Failed to get task ID from response")
    exit(1)

print(f"Task ID: {task_id}")

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
print("
Step 2: Polling task status...")

while True:
    query_response = requests.get(
        f"{BASE_URL}/videos/{task_id}", headers=headers
    )
    query_result = query_response.json()

    data = query_result.get("data", {})
    status = data.get("status", "unknown")
    progress = data.get("progress", "0%")
    print(f"Status: {status}, Progress: {progress}")

    if status in ["FAILURE", "failed"]:
        print("Video generation failed!")
        print(f"Reason: {data.get('fail_reason')}")
        exit(1)

    if status == "SUCCESS":
        video_url = data.get("data", {}).get("video", {}).get("url")
        print(f"Video generation completed!")
        print(f"Video URL: {video_url}")
        break

    time.sleep(10)

Python Code Example

import os
import time
import requests

# Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/grok/v1"

headers = {
    "Authorization": f"Bearer {COMETAPI_KEY}",
    "Content-Type": "application/json",
}

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
print("Step 1: Creating video generation task...")

create_payload = {
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p",
}

create_response = requests.post(
    f"{BASE_URL}/videos/generations", headers=headers, json=create_payload
)

create_result = create_response.json()
print(f"Create response: {create_result}")

# Extract task ID from the response
task_id = create_result.get("request_id") or create_result.get("id")
if not task_id:
    print("Error: Failed to get task ID from response")
    exit(1)

print(f"Task ID: {task_id}")

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
print("\nStep 2: Polling task status...")

while True:
    query_response = requests.get(
        f"{BASE_URL}/videos/{task_id}", headers=headers
    )
    query_result = query_response.json()

    data = query_result.get("data", {})
    status = data.get("status", "unknown")
    progress = data.get("progress", "0%")
    print(f"Status: {status}, Progress: {progress}")

    if status in ["FAILURE", "failed"]:
        print("Video generation failed!")
        print(f"Reason: {data.get('fail_reason')}")
        exit(1)

    if status == "SUCCESS":
        video_url = data.get("data", {}).get("video", {}).get("url")
        print(f"Video generation completed!")
        print(f"Video URL: {video_url}")
        break

    time.sleep(10)

JavaScript Code Example

// Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
const api_key = process.env.COMETAPI_KEY || "<YOUR_COMETAPI_KEY>";
const base_url = "https://api.cometapi.com/grok/v1";

const headers = {
  "Authorization": `Bearer ${api_key}`,
  "Content-Type": "application/json",
};

// ============================================================
// Step 1: Create Video Generation Task
// ============================================================
console.log("Step 1: Creating video generation task...");

const createPayload = {
  model: "grok-imagine-video",
  prompt: "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
  duration: 10,
  aspect_ratio: "16:9",
  resolution: "720p",
};

const createResponse = await fetch(`${base_url}/videos/generations`, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(createPayload),
});

const createResult = await createResponse.json();
console.log("Create response:", JSON.stringify(createResult, null, 2));

const taskId = createResult?.request_id || createResult?.id;
if (!taskId) {
  console.log("Error: Failed to get task ID from response");
  process.exit(1);
}

console.log(`Task ID: ${taskId}`);

// ============================================================
// Step 2: Poll for Task Status
// ============================================================
console.log("\nStep 2: Polling task status...");

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

while (true) {
  const queryResponse = await fetch(`${base_url}/videos/${taskId}`, {
    method: "GET",
    headers: headers,
  });

  const queryResult = await queryResponse.json();
  const data = queryResult?.data || {};
  const status = data?.status || "unknown";
  const progress = data?.progress || "0%";
  console.log(`Status: ${status}, Progress: ${progress}`);

  if (["FAILURE", "failed"].includes(status)) {
    console.log("Video generation failed!");
    console.log(`Reason: ${data?.fail_reason}`);
    process.exit(1);
  }

  if (status === "SUCCESS") {
    const videoUrl = data?.data?.video?.url;
    console.log("Video generation completed!");
    console.log(`Video URL: ${videoUrl}`);
    break;
  }

  await sleep(10000);
}

Curl Code Example

#!/bin/bash

# Get your CometAPI key from https://api.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"

BASE_URL="https://api.cometapi.com/grok/v1"

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
echo "Step 1: Creating video generation task..."

CREATE_RESPONSE=$(curl -s --location --request POST "${BASE_URL}/videos/generations" \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }')

echo "Create response: $CREATE_RESPONSE"

# Extract task ID using jq (install with: brew install jq)
TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.request_id // .id')

if [ "$TASK_ID" == "null" ] || [ -z "$TASK_ID" ]; then
  echo "Error: Failed to get task ID from response"
  exit 1
fi

echo "Task ID: $TASK_ID"

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
echo ""
echo "Step 2: Polling task status..."

while true; do
  QUERY_RESPONSE=$(curl -s --location --request GET "${BASE_URL}/videos/${TASK_ID}" \
    --header "Authorization: Bearer $COMETAPI_KEY")

  STATUS=$(echo "$QUERY_RESPONSE" | jq -r '.data.status')
  PROGRESS=$(echo "$QUERY_RESPONSE" | jq -r '.data.progress')
  echo "Status: $STATUS, Progress: $PROGRESS"

  if [ "$STATUS" == "FAILURE" ] || [ "$STATUS" == "failed" ]; then
    echo "Video generation failed!"
    echo "$QUERY_RESPONSE" | jq -r '.data.fail_reason'
    exit 1
  fi

  if [ "$STATUS" == "SUCCESS" ]; then
    VIDEO_URL=$(echo "$QUERY_RESPONSE" | jq -r '.data.data.video.url')
    echo "Video generation completed!"
    echo "Video URL: $VIDEO_URL"
    break
  fi

  sleep 10
done