Skip to main content
GET
Utilisez ce endpoint une fois que vous avez déjà un request_id. Il vous indique si la tâche xAI est toujours en cours d’exécution 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 l’état de la tâche xAI ; continuez à interroger jusqu’à ce qu’il atteigne done
  • progress pour 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 le request_id renvoyé.
2

Continuez à interroger jusqu’à ce que le status soit done

Si la réponse ne fait que renvoyer request_id, attendez quelques secondes puis interrogez à nouveau. Une fois que status apparaît, utilisez-le comme condition d’arrêt.
3

Conservez le fichier terminé

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

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Paramètres de chemin

​
request_id
string
requis

Deferred request id returned by the create or edit endpoint.

Réponse

200 - application/json

Current xAI video task state.

​
request_id
string

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

​
model
string

xAI video model id.

​
usage
object

Billing metadata. cost_in_usd_ticks reports the cost in provider ticks.

​
video
object

Generated video metadata. Present when the job has completed.

​
status
enum<string>

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

Options disponibles:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.