Endpoint /v1/videos/generations : votre premiere video

Generer une video a partir d’un texte

L’API xAI propose un endpoint dedie a la generation video : POST /v1/videos/generations. Ce point d’entree transforme une description textuelle en une video animee grace au modele grok-imagine-video. Que vous souhaitiez creer des clips promotionnels, des visualisations de concepts ou des animations creatives, tout commence ici.

Dans cette lecon, vous allez decouvrir la structure d’une requete text-to-video, les parametres disponibles et le cout associe.

Structure de la requete

L’endpoint POST /v1/videos/generations accepte un objet JSON avec les parametres suivants :

{
  "model": "grok-imagine-video",
  "prompt": "Un dauphin sautant dans un coucher de soleil",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}

• model : toujours grok-imagine-video, le seul modele video disponible actuellement
• prompt : votre description textuelle de la scene souhaitee
• duration : duree en secondes, entre 1 et 15
• aspect_ratio : ratio d’image (16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3)
• resolution : 480p (defaut) ou 720p

Modele et tarification

Le modele grok-imagine-video est facture a $0.050 par seconde de video generee. Pour une video de 5 secondes, le cout sera de $0.25. La limite de debit est fixee a 60 requetes par minute (RPM).

Le processus de generation est asynchrone : vous soumettez la requete, recevez un request_id, puis interrogez le statut jusqu’a ce que la video soit prete. Nous detaillerons ce workflow dans les lecons suivantes.

Exemple avec curl

Voici une requete complete pour generer une video de 5 secondes :

curl -X POST "https://api.x.ai/v1/videos/generations" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "Un chat jouant avec une pelote de laine dans un salon lumineux",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

La reponse contient un identifiant unique :

{
  "request_id": "vid_abc123def456"
}

Conservez ce request_id : il vous servira a recuperer votre video une fois la generation terminee.

Tailles alternatives

En plus du parametre aspect_ratio, vous pouvez utiliser le parametre size pour specifier directement les dimensions en pixels :

• 848x480 (equivalent 480p 16:9)
• 1280x720 (equivalent 720p 16:9)
• 1696x960
• 1920x1080

Ces valeurs offrent un controle plus precis sur la resolution de sortie, notamment pour des formats non standards.

Points cles a retenir

• L’endpoint est POST /v1/videos/generations avec le modele grok-imagine-video
• La duree va de 1 a 15 secondes, la resolution de 480p a 720p
• La tarification est de $0.050 par seconde generee
• La generation est asynchrone : vous recevez un request_id a interroger ensuite
• Sept ratios d’aspect sont disponibles pour s’adapter a tous les formats