> ## 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.
# Obtener resultados de video de xAI
> Usa GET /grok/v1/videos/{request_id} 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.
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
Comienza con [Crear un video de xAI](./video-generation) o [Crear una edición de video de xAI](./video-edit), y luego copia el `request_id` devuelto.
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.
Descarga o copia la `video.url` final de inmediato, porque xAI documenta las URL generadas como temporales.
## OpenAPI
````yaml api/openapi/video/xai/get-get-video-generation-results.openapi.json GET /grok/v1/videos/{request_id}
openapi: 3.1.0
info:
title: Get Video Generation Results API
version: 1.0.0
description: >-
Query an xAI Grok video job created through CometAPI and read the final
temporary video URL when the job is complete.
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/grok/v1/videos/{request_id}:
get:
summary: Query an xAI video job
description: >-
Use the request_id from the generation or edit endpoint to poll status
until the job completes. xAI documents the final video URL as temporary.
operationId: get_video_generation_results
parameters:
- name: request_id
in: path
required: true
description: Deferred request id returned by the create or edit endpoint.
schema:
type: string
responses:
'200':
description: Current xAI video task state.
content:
application/json:
schema:
type: object
properties:
request_id:
type: string
description: >-
Returned when the request is accepted but result metadata
is not ready yet.
model:
type: string
description: xAI video model id.
usage:
type: object
properties:
cost_in_usd_ticks:
type: integer
description: Billing usage value returned by xAI.
description: >-
Billing metadata. `cost_in_usd_ticks` reports the cost in
provider ticks.
video:
type: object
description: >-
Generated video metadata. Present when the job has
completed.
properties:
url:
type: string
description: Temporary URL for the generated MP4.
duration:
type: integer
description: Video duration in seconds.
respect_moderation:
type: boolean
description: Moderation flag returned with the video.
status:
type: string
description: xAI job state. `done` means the video metadata is ready.
enum:
- queued
- processing
- done
- failed
- expired
progress:
type: integer
description: Completion percentage when returned.
error:
description: Error details when the job fails.
nullable: true
oneOf:
- type: string
- type: object
examples:
accepted:
summary: Task accepted, keep polling
value:
request_id:
done:
summary: Task finished successfully
value:
model: grok-imagine-video-1.5
usage:
cost_in_usd_ticks: 500000000
video:
url: https://example.com/xai-video.mp4
duration: 1
respect_moderation: true
status: done
progress: 100
example:
model: grok-imagine-video-1.5
usage:
cost_in_usd_ticks: 500000000
video:
url: https://example.com/xai-video.mp4
duration: 1
respect_moderation: true
status: done
progress: 100
x-codeSamples:
- lang: Shell
label: Default
source: |
REQUEST_ID=""
curl "https://api.cometapi.com/grok/v1/videos/$REQUEST_ID" \
-H "Authorization: Bearer $COMETAPI_KEY"
- lang: Shell
label: Poll until done
source: |
REQUEST_ID=""
while true; do
STATUS=$(curl -s "https://api.cometapi.com/grok/v1/videos/$REQUEST_ID" \
-H "Authorization: Bearer $COMETAPI_KEY" | python3 -c "import json,sys; print(json.load(sys.stdin)['status'])")
echo "status: $STATUS"
case "$STATUS" in done | failed | expired) break;; esac
sleep 20
done
- lang: Python
label: Default
source: |
import os
import requests
request_id = ""
response = requests.get(
f"https://api.cometapi.com/grok/v1/videos/{request_id}",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
)
print(response.json())
- lang: Python
label: Poll until done
source: |
import os
import time
import requests
request_id = ""
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
while True:
task = requests.get(
f"https://api.cometapi.com/grok/v1/videos/{request_id}", headers=headers
).json()
print(task.get("status"), task.get("progress"))
if task.get("status") in ("done", "failed", "expired"):
break
time.sleep(10)
if task.get("status") == "done":
print(task["video"]["url"])
- lang: JavaScript
label: Default
source: >
const requestId = "";
const response = await
fetch(`https://api.cometapi.com/grok/v1/videos/${requestId}`, {
headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` },
});
console.log(await response.json());
- lang: JavaScript
label: Poll until done
source: >
const requestId = "";
const headers = { Authorization: `Bearer
${process.env.COMETAPI_KEY}` };
let task;
while (true) {
task = await (await fetch(`https://api.cometapi.com/grok/v1/videos/${requestId}`, { headers })).json();
console.log(task.status, task.progress);
if (["done", "failed", "expired"].includes(task.status)) break;
await new Promise((resolve) => setTimeout(resolve, 10000));
}
if (task.status === "done") console.log(task.video.url);
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````