Перейти до основного вмісту
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.

Використовуйте цей endpoint, якщо у вас уже є request_id. Він повідомляє, чи завдання xAI ще виконується, і повертає фінальні метадані відео, коли все буде готово.

​
Спочатку перевірте ці поля

  • request_id, коли завдання було прийнято, але результат ще не готовий
  • status для стану завдання xAI; продовжуйте опитування, доки воно не досягне done
  • progress для відсотка завершення, якщо його повернуто
  • video.url, коли рендеринг завершено

​
Цикл опитування

1

Спочатку створіть або відредагуйте відео

Почніть із Video Generation або Video Edit, а потім скопіюйте повернений request_id.
2

Продовжуйте опитування, доки status не стане done

Якщо відповідь лише повторює request_id, зачекайте кілька секунд і виконайте опитування знову. Щойно з’явиться status, використовуйте його як умову зупинки.
3

Збережіть готовий файл

Завантажте або скопіюйте фінальний video.url якомога швидше, оскільки xAI документує згенеровані URL як тимчасові.

Авторизації

​
Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Параметри шляху

​
request_id
string
обов'язково

Deferred request id returned by the create or edit endpoint.

Відповідь

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.

Доступні опції:
queued,
processing,
done,
failed,
expired
​
progress
integer

Completion percentage when returned.

​
error

Error details when the job fails.