Skip to main content
GET
cURL
Utilisez ce endpoint après avoir déjà obtenu un request_id. Il vous indique si la tâche xAI est toujours en cours et renvoie les métadonnées finales de la vidéo lorsqu’elles sont prêtes.

Vérifiez d’abord ces champs

  • request_id lorsque la tâche a été acceptée, mais que le résultat n’est pas encore prêt
  • status pour connaître l’état de la tâche xAI ; continuez à interroger tant qu’il est pending, et arrêtez-vous sur done, failed ou expired
  • progress pour connaître le pourcentage d’achèvement lorsqu’il est renvoyé
  • video.url lorsque le rendu est terminé

Boucle d’interrogation

1

Créez ou modifiez d’abord la vidéo

Commencez par Créer une vidéo xAI ou Créer une modification de vidéo xAI, puis copiez l’request_id.
2

Interrogez jusqu’à ce que la tâche atteigne un état terminal

Si la réponse se contente de renvoyer request_id, attendez quelques secondes et interrogez de nouveau. Continuez tant que status est pending ; arrêtez-vous sur done, failed ou expired.
3

Enregistrez le fichier final

Téléchargez ou copiez rapidement l’video.url final, car xAI indique que les URL générées sont temporaires.

Autorisations

Authorization
string
header
requis

Use your CometAPI API key as the bearer value.

Paramètres de chemin

request_id
string
requis

The deferred request ID returned by the create or edit endpoint.

Réponse

200 - application/json

The current Grok video task state.

request_id
string

Returned when the request is accepted but result metadata is not ready yet.

model
string

The Grok video model ID.

video
object

Generated video metadata. Present when the job has completed.

status
enum<string>

The job state. done means the video metadata is ready.

Options disponibles:
pending,
done,
failed,
expired
progress
integer

Completion percentage when returned.

usage
object

Additional usage metadata returned when the job is complete. Its contents can vary by model.

error

Error details when the job fails.

Dernière modification le 21 août 2026