Obter Resultados da Geração de Vídeo

Use GET /grok/v1/videos/ para consultar o status da geração de vídeo do xAI e recuperar a URL final do vídeo assim que o processamento for concluído.

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"
    }
  }
}

Use este endpoint depois que você já tiver um request_id. Ele informa se o job do xAI ainda está em execução e retorna os metadados finais do vídeo quando estiver pronto.

​

Verifique estes campos primeiro

• code e message do wrapper para erros de nível superior
• data.status para o estado da tarefa no CometAPI
• data.data.status para o estado aninhado do provider
• data.data.video.url quando a renderização estiver concluída

​

Loop de polling

1. Crie ou edite o vídeo primeiro

   Comece com Video Generation ou Video Edit e, em seguida, copie o request_id retornado.

2. Continue fazendo polling até que o status aninhado seja done

   Verifique tanto os campos do wrapper quanto os campos aninhados do provider para distinguir falhas do wrapper de falhas no nível do provider.

3. Armazene o arquivo concluído

   Faça o download ou copie o video.url final rapidamente, porque o xAI documenta as URLs geradas como temporárias.

​

O que esperar no CometAPI

Este ainda é o mesmo passo de polling que o xAI descreve em seu fluxo de trabalho oficial. O CometAPI adiciona um envelope wrapper em torno do payload do provider para que você possa lidar com jobs assíncronos de forma mais consistente entre providers.

Autorizações

Authorization · string · header · obrigatório

Bearer token authentication. Use your CometAPI key.

Parâmetros de caminho

request_id · string · obrigatório

Deferred request id returned by the create or edit endpoint.

Resposta

200 - application/json

Current task state.

code · string · obrigatório

message · string · obrigatório

data · object · obrigatório

Show child attributes