Passer au contenu principal
GET
/
grok
/
v1
/
videos
/
{request_id}
Query an xAI video job
curl --request GET \
  --url https://api.cometapi.com/grok/v1/videos/{request_id} \
  --header 'Authorization: Bearer <token>'
{
  "request_id": "f5f35814-953e-b094-5a2c-4a90014a58cb"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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’avancement 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 Video Generation ou Video Edit, puis copiez le request_id renvoyé.
2

Continuez à interroger jusqu’à ce que 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 final

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
​
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.