Saltar al contenido 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"
    }
  }
}
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