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>'
{
  "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 disposez déjà d’un request_id. Il 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

  • Le wrapper code et message pour les erreurs de premier niveau
  • 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éer ou modifier la vidéo d’abord

Commencez par Video Generation ou Video Edit, puis copiez le request_id renvoyé.
2

Continuer le polling jusqu’à ce que l’état imbriqué soit done

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

Conserver le fichier terminé

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

​
À quoi s’attendre sur CometAPI

Il s’agit toujours de la même étape de polling que xAI décrit dans son workflow officiel. CometAPI ajoute une enveloppe wrapper autour de la charge utile du fournisseur afin que vous puissiez gérer les tâches async de manière plus cohérente entre les fournisseurs.

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