Obtener resultados de generación de video

Usa GET /grok/v1/videos/ para consultar el estado de generación de video de xAI y recuperar la URL final del video una vez que se complete el procesamiento.

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

Usa este endpoint cuando ya tengas un request_id. Te indica si el trabajo de xAI sigue en ejecución y devuelve los metadatos finales del video cuando esté listo.

​

Revisa primero estos campos

• code y message del wrapper para errores de nivel superior
• data.status para el estado de la tarea en CometAPI
• data.data.status para el estado anidado del proveedor
• data.data.video.url cuando el renderizado esté completo

​

Bucle de sondeo

1. Crea o edita primero el video

   Comienza con Video Generation o Video Edit, luego copia el request_id devuelto.

2. Sigue consultando hasta que el estado anidado sea done

   Revisa tanto los campos del wrapper como los campos anidados del proveedor para poder distinguir los fallos del wrapper de los fallos a nivel del proveedor.

3. Guarda el archivo terminado

   Descarga o copia la video.url final de inmediato, porque xAI documenta las URL generadas como temporales.

​

Qué esperar en CometAPI

Este sigue siendo el mismo paso de consulta que xAI describe en su flujo de trabajo oficial. CometAPI añade un envoltorio wrapper alrededor del payload del proveedor para que puedas gestionar trabajos asíncronos de forma más coherente entre proveedores.

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication. Use your CometAPI key.

Parámetros de ruta

request_id · string · requerido

Deferred request id returned by the create or edit endpoint.

Respuesta

200 - application/json

Current task state.

code · string · requerido

message · string · requerido

data · object · requerido

Show child attributes