API vidéo Grok

Cette page décrit l’appel des modèles vidéo Grok de xAI, grok-imagine-video et grok-imagine-video-1.5. Comme les autres modèles vidéo, ils se créent avec POST /v1/videos et s’interrogent avec GET /v1/videos/{id} ; l’authentification, les états d’interrogation, le téléchargement des résultats et la gestion des erreurs sont décrits dans la spécification complète de l’API vidéo. Cette page ne présente que les champs et règles propres à Grok.

Mis à jour le 2026-10-10. L’ancien grok-imagine-video-1.5-1080p a été retiré : pour du 1080P, utilisez grok-imagine-video-1.5 avec "resolution": "1080p". Grok définit le format d’image avec aspect_ratio (ou ratio, ou size). Grok prend en charge uniquement l’interrogation : ne définissez pas callback_url.

Modèles

Paramètres

• Résolution : resolution accepte 480p et 720p, ainsi que 1080p pour grok-imagine-video-1.5. Elle peut aussi figurer dans metadata.resolution.
• Durée : nombre entier de secondes de 1 à 15 dans duration (ou seconds sous forme de chaîne).
• Format d’image : aspect_ratio et ratio sont équivalents ; vous pouvez aussi indiquer le format dans size (par exemple "size": "9:16"). size n’accepte pas de dimensions en pixels. Si vous envoyez plusieurs champs de format (y compris dans metadata), leurs valeurs doivent concorder, sinon la requête renvoie 400.
• Image : une seule au maximum, sous forme d’URL https:// publique, dans images, image ou input_reference. La même image écrite une fois dans deux champs compte pour 2 images et renvoie 400.
• Prompt : prompt peut être omis si une image est fournie ; une requête sans aucun des deux renvoie 400.
• Non pris en charge : images de début et de fin, vidéos de référence, audio de référence, negative_prompt, seed, generate_audio et téléversement de fichiers en multipart/form-data.

Texte vers vidéo

{
  "model": "grok-imagine-video-1.5",
  "prompt": "Voiture de sport argentée dans une ville pluvieuse la nuit, travelling en contre-plongée, reflets de néons, rendu cinématographique",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p"
}

Image vers vidéo

{
  "model": "grok-imagine-video",
  "prompt": "Garder le sujet de l’image de référence, lent travelling arrière depuis un plan rapproché, rendu cinématographique",
  "duration": 6,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "images": ["https://cdn.example.com/start.jpg"]
}