Skip to main content
GET
Use este endpoint depois que você já tiver um request_id. Ele informa se o job 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 foi aceita, mas o resultado ainda não está pronto
  • status para o estado do job xAI; continue consultando até que ele chegue a done
  • progress para 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 xAI ou Criar uma edição de vídeo xAI e depois copie o request_id retornado.
2

Continue consultando até status ser done

Se a resposta apenas repetir request_id, aguarde alguns segundos e consulte novamente. Quando status aparecer, use-o como condição de parada.
3

Armazene o arquivo concluído

Faça o download ou copie o video.url final rapidamente, porque a documentação da xAI descreve as URLs geradas como temporárias.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Parâmetros de caminho

​
request_id
string
obrigatório

Deferred request id returned by the create or edit endpoint.

Resposta

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.

Opções disponíveis:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.