Vai al contenuto principale
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 questo endpoint quando hai già un request_id. Ti indica se il job xAI è ancora in esecuzione e restituisce i metadati finali del video quando sono pronti.

​
Controlla prima questi campi

  • request_id quando il task è stato accettato ma il risultato non è ancora pronto
  • status per lo stato del job xAI; continua a fare polling finché non raggiunge done
  • progress per la percentuale di completamento quando viene restituito
  • video.url quando il rendering è completo

​
Ciclo di polling

1

Crea o modifica prima il video

Inizia con Video Generation o Video Edit, quindi copia il request_id restituito.
2

Continua a fare polling finché lo status non è done

Se la risposta riporta solo request_id, attendi qualche secondo e fai di nuovo polling. Quando compare status, usalo come condizione di arresto.
3

Salva il file completato

Scarica o copia tempestivamente il video.url finale, perché la documentazione di xAI indica che gli URL generati sono temporanei.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Parametri del percorso

​
request_id
string
obbligatorio

Deferred request id returned by the create or edit endpoint.

Risposta

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.

Opzioni disponibili:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.