Obtenir les résultats de génération vidéo

Utilisez GET /grok/v1/videos/ pour interroger l’état de la génération vidéo xAI et récupérer l’URL finale de la vidéo une fois le traitement terminé.

GET /grok/v1/videos/{request_id}

Query an xAI video job

cURL

curl --request GET \
  --url https://api.cometapi.com/grok/v1/videos/{request_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3",
    "action": "VIDEO_GENERATION",
    "status": "SUCCESS",
    "fail_reason": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
    "submit_time": 1773297002,
    "start_time": 0,
    "finish_time": 1773297014,
    "progress": "100%",
    "data": {
      "model": "grok-imagine-video",
      "usage": {
        "cost_in_usd_ticks": 500000000
      },
      "video": {
        "url": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
        "duration": 1,
        "respect_moderation": true
      },
      "status": "done"
    }
  }
}

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

• code et message pour les erreurs de niveau supérieur
• data.status pour l’état de la tâche CometAPI
• data.data.status pour l’état imbriqué du fournisseur
• data.data.video.url lorsque le rendu est terminé

​

Boucle de polling

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 le polling jusqu’à ce que le statut imbriqué soit terminé

   Vérifiez à la fois les champs de niveau supérieur et ceux du fournisseur imbriqué afin de pouvoir distinguer les échecs de niveau supérieur des échecs au niveau du fournisseur.

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 task state.

code · string · requis

message · string · requis

data · object · requis

Show child attributes