Skip to main content
GET
cURL
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 vídeo cuando están listos.

Comprueba primero estos campos

  • request_id cuando la tarea se haya aceptado, pero el resultado aún no esté listo
  • status para conocer el estado del trabajo de xAI; sigue consultando mientras sea pending y detente cuando sea done, failed o expired
  • progress para conocer el porcentaje de finalización cuando se devuelva
  • video.url cuando se complete el renderizado

Bucle de consulta

1

Crea o edita primero el vídeo

Empieza por Crear un vídeo de xAI o Crear una edición de vídeo de xAI, y después copia el request_id devuelto.
2

Consulta hasta que la tarea alcance un estado terminal

Si la respuesta solo repite request_id, espera unos segundos y vuelve a consultar. Continúa mientras status sea pending; detente cuando sea done, failed o expired.
3

Guarda el archivo finalizado

Descarga o copia de inmediato el video.url final, ya que xAI documenta que las URL generadas son temporales.

Autorizaciones

Authorization
string
header
requerido

Use your CometAPI API key as the bearer value.

Parámetros de ruta

request_id
string
requerido

The deferred request ID returned by the create or edit endpoint.

Respuesta

200 - application/json

The current Grok video task state.

request_id
string

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

model
string

The Grok video model ID.

video
object

Generated video metadata. Present when the job has completed.

status
enum<string>

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

Opciones disponibles:
pending,
done,
failed,
expired
progress
integer

Completion percentage when returned.

usage
object

Additional usage metadata returned when the job is complete. Its contents can vary by model.

error

Error details when the job fails.

Última modificación el 21 de agosto de 2026