Skip to main content
GET
Usa questo endpoint dopo avere 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 l’attività è stata accettata ma il risultato non è ancora pronto
  • status per lo stato del job xAI; continua a interrogare finché non raggiunge done
  • progress per la percentuale di completamento quando viene restituita
  • video.url quando il rendering è completo

Ciclo di polling

1

Crea o modifica prima il video

Inizia con Creare un video xAI o Creare una modifica video xAI, quindi copia il request_id restituito.
2

Continua a interrogare finché status non è done

Se la risposta restituisce solo request_id, attendi alcuni secondi e interroga di nuovo. Una volta che appare status, usalo come condizione di arresto.
3

Salva il file completato

Scarica o copia subito il video.url finale, perché xAI documenta gli URL generati come 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

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.

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

Completion percentage when returned.

error

Error details when the job fails.