Skip to main content
GET
Usa este endpoint después de que 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é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 alcance done
  • progress para el porcentaje de finalización cuando se devuelva
  • video.url cuando el renderizado esté completo

Bucle de consulta

1

Primero crea o edita el video

Comienza con Crear un video de xAI o Crear una edición de video de xAI, y 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 detención.
3

Guarda el archivo final

Descarga o copia la video.url final de inmediato, porque xAI documenta las URL generadas como 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

Billing metadata. cost_in_usd_ticks reports the cost in provider ticks.

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.