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>'
{
  "request_id": "f5f35814-953e-b094-5a2c-4a90014a58cb"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Usa este endpoint cuando ya tengas un request_id. Te indica si el trabajo de xAI sigue ejecutándose y devuelve los metadatos finales del video cuando están listos.

​
Revisa primero estos campos

  • request_id cuando la tarea ha sido aceptada pero el resultado aún no está listo
  • status para el estado del trabajo de xAI; sigue consultando hasta que llegue a done
  • progress para el porcentaje de finalización cuando se devuelva
  • video.url cuando el renderizado esté completo

​
Bucle de consulta

1

Crea o edita el video primero

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

Sigue consultando hasta que status sea done

Si la respuesta solo devuelve request_id, espera unos segundos y vuelve a consultar. Una vez que aparezca status, úsalo como condición de parada.
3

Guarda el archivo terminado

Descarga o copia la video.url final de inmediato, porque la documentación de xAI indica que las URL generadas son temporales.

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

​
request_id
string

Returned when the request is accepted but result metadata is not ready yet.

​
model
string

xAI video model id.

​
usage
object
​
video
object

Generated video metadata. Present when the job has completed.

​
status
enum<string>

xAI job state. done means the video metadata is ready.

Opciones disponibles:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.