Guides d’intégration
Erreurs
Tarification et facturation
xAI
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 --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."
}
'{
"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à1etresolutionà480p - Ajoutez
image.urluniquement 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
Interroger jusqu’à la fin
Appelez Get Video Generation Results jusqu’à ce que le statut du provider imbriqué devienne
done.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
Bearer token authentication. Use your CometAPI key.
Corps
application/json
Prompt for the video job.
Exemple:
"A candle flickers on a wooden table."
Output aspect ratio.
Options disponibles:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
Exemple:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
Options disponibles:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
Réponse
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
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."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}