Skip to main content
GET
cURL
Use este endpoint depois que você já tiver um request_id. Ele informa se o trabalho da xAI ainda está em execução e retorna os metadados finais do vídeo quando estiver pronto.

Verifique estes campos primeiro

  • request_id quando a tarefa tiver sido aceita, mas o resultado ainda não estiver pronto
  • status para verificar o estado do trabalho da xAI; continue consultando enquanto estiver pending e pare em done, failed ou expired
  • progress para verificar a porcentagem de conclusão quando ela for retornada
  • video.url quando a renderização estiver concluída

Loop de consulta

1

Crie ou edite o vídeo primeiro

Comece com Criar um vídeo da xAI ou Criar uma edição de vídeo da xAI, depois copie o request_id retornado.
2

Consulte até que a tarefa alcance um estado terminal

Se a resposta apenas repetir request_id, aguarde alguns segundos e consulte novamente. Continue enquanto status for pending; pare em done, failed ou expired.
3

Mantenha o arquivo concluído

Baixe ou copie prontamente o video.url final, pois a xAI documenta as URLs geradas como temporárias.

Autorizações

Authorization
string
header
obrigatório

Use your CometAPI API key as the bearer value.

Parâmetros de caminho

request_id
string
obrigatório

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

Resposta

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.

Opções disponíveis:
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 modificação em 21 de agosto de 2026