Skip to main content
GET
cURL
Usa questo endpoint dopo aver già ottenuto un request_id. Ti indica se il job xAI è ancora in esecuzione e restituisce i metadati del video finale quando è pronto.

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 effettuare il polling finché è pending, e interrompi con done, failed o expired
  • 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 Crea un video xAI oppure Crea una modifica di un video xAI, quindi copia il valore request_id restituito.
2

Esegui il polling finché l'attività non raggiunge uno stato terminale

Se la risposta si limita a ripetere request_id, attendi alcuni secondi ed esegui di nuovo il polling. Continua finché status è pending; interrompi con done, failed o expired.
3

Mantieni il file completato

Scarica o copia tempestivamente il valore finale video.url, poiché xAI documenta gli URL generati come temporanei.

Autorizzazioni

Authorization
string
header
obbligatorio

Use your CometAPI API key as the bearer value.

Parametri del percorso

request_id
string
obbligatorio

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

Risposta

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.

Opzioni disponibili:
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.

Ultima modifica il 21 agosto 2026