Génération de vidéos

Utilisez CometAPI POST /grok/v1/videos/generations pour créer des vidéos avec Grok, animer une image d’entrée via un prompt et interroger les résultats via request_id.

POST /grok/v1/videos/generations

cURL

Validated request

curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A candle flickers on a wooden table."
}
'

200

{
  "request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}

Utilisez ce endpoint pour démarrer une tâche vidéo Grok à partir de texte, ou de texte plus une image source. Il renvoie immédiatement un request_id, considérez-le donc comme la première étape d’un workflow asynchrone.

​

Commencez avec une petite requête

• Utilisez model: grok-imagine-video
• Pour un test rapide, gardez duration à 1 et resolution à 480p
• Ajoutez image.url uniquement lorsque vous voulez faire de l’image-vers-vidéo
• Si vous envoyez du base64, conservez dans la documentation et l’exemple OpenAPI le format data:image/png;base64,<BASE64_IMAGE_DATA>

​

Flux de tâche

1. Créer la tâche

   Envoyez le prompt et enregistrez le request_id renvoyé.

2. Interroger jusqu’à la fin

   Appelez Get Video Generation Results jusqu’à ce que le statut du provider imbriqué devienne done.

3. Conserver la sortie

   Copiez l’URL finale video.url dans votre propre stockage si vous en avez besoin après la fenêtre de mise à disposition temporaire du provider.

​

Ce qui change sur CometAPI

xAI documente la génération vidéo comme un flux en deux étapes start -> poll. CometAPI conserve la même forme de requête et le même id de modèle principal, mais vous vous authentifiez avec votre clé CometAPI et restez sur l’URL de base CometAPI. Une requête réelle de 1 seconde en 480p a été exécutée avec succès le 2026-03-12 et a renvoyé une véritable URL de résultat.

Autorisations

Authorization · string · header · requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json

prompt · string · requis

Prompt for the video job.

Exemple:

"A candle flickers on a wooden table."

aspect_ratio · enum<string>

Output aspect ratio.

Options disponibles: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3

duration · integer · défaut: 1

Output duration in seconds. xAI documents a range of 1 to 15 seconds.

image · object

Optional source image for image-to-video.

Show child attributes

model · string · défaut: grok-imagine-video

xAI video model id.

Exemple:

"grok-imagine-video"

output · object

Show child attributes

resolution · enum<string>

Output resolution.

Options disponibles: 480p, 720p

size · string

Deprecated size field. Prefer aspect_ratio and resolution.

user · string

Optional end-user identifier.

Réponse

200 - application/json

Request accepted.

request_id · string · requis

Deferred request id used for polling.