Генерация видео

Используйте CometAPI POST /grok/v1/videos/generations, чтобы создавать видео с помощью Grok, анимировать входное изображение через prompt и опрашивать результаты по request_id.

POST /grok/v1/videos/generations

cURL

Validated request

curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A candle flickers on a wooden table."
}
'

200

{
  "request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}

Используйте этот endpoint, чтобы запустить задачу генерации видео Grok из текста или из текста плюс одного исходного изображения. Он сразу возвращает request_id, поэтому рассматривайте это как первый шаг в асинхронном workflow.

​

Начните с небольшого запроса

• Используйте model: grok-imagine-video
• Для быстрой проверки оставьте duration равным 1, а resolution — 480p
• Добавляйте image.url только если хотите использовать режим image-to-video
• Если вы отправляете base64, сохраняйте форму из документации и примера OpenAPI как data:image/png;base64,<BASE64_IMAGE_DATA>

​

Поток задачи

1. Создайте задачу

   Отправьте prompt и сохраните возвращённый request_id.

2. Опрашивайте завершение

   Вызывайте Get Video Generation Results, пока вложенный статус provider не станет done.

3. Сохраните результат

   Скопируйте финальный video.url в своё собственное хранилище, если он нужен вам после временного окна доставки у provider.

​

Что меняется в CometAPI

xAI описывает генерацию видео как двухшаговый поток запуск -> опрос. CometAPI сохраняет ту же форму запроса и тот же основной id модели, но вы проходите аутентификацию с помощью своего ключа CometAPI и остаетесь на базовом URL CometAPI. Реальный запрос на 1 секунду в 480p был успешно выполнен 2026-03-12 и вернул реальный URL результата.

Авторизации

Authorization · string · header · обязательно

Bearer token authentication. Use your CometAPI key.

Тело

application/json

prompt · string · обязательно

Prompt for the video job.

Пример:

"A candle flickers on a wooden table."

aspect_ratio · enum<string>

Output aspect ratio.

Доступные опции: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3

duration · integer · по умолчанию: 1

Output duration in seconds. xAI documents a range of 1 to 15 seconds.

image · object

Optional source image for image-to-video.

Show child attributes

model · string · по умолчанию: grok-imagine-video

xAI video model id.

Пример:

"grok-imagine-video"

output · object

Show child attributes

resolution · enum<string>

Output resolution.

Доступные опции: 480p, 720p

size · string

Deprecated size field. Prefer aspect_ratio and resolution.

user · string

Optional end-user identifier.

Ответ

200 - application/json

Request accepted.

request_id · string · обязательно

Deferred request id used for polling.