Saltar para o conteúdo principal
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.

Use este endpoint depois que você já tiver um request_id. Ele informa se o trabalho do 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 o estado do trabalho do xAI; continue consultando até que atinja done
  • progress para a porcentagem de conclusão quando ela for retornada
  • video.url quando a renderização estiver concluída

​
Loop de polling

1

Crie ou edite o vídeo primeiro

Comece com Video Generation ou Video Edit e depois copie o request_id retornado.
2

Continue consultando até que o status seja done

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

Persista o arquivo concluído

Faça o download ou copie a video.url final rapidamente, porque a documentação do 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
​
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.