Перейти до основного вмісту
POST
/
grok
/
v1
/
videos
/
generations
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."
}
'
{
  "request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}
Використовуйте цей endpoint, щоб запустити завдання Grok для відео з тексту або з тексту та одного вихідного зображення. Він одразу повертає request_id, тож розглядайте це як перший крок в асинхронному робочому процесі.

Почніть із малого запиту

  • Використовуйте 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, доки вкладений статус провайдера не стане done.
3

Збережіть результат

Скопіюйте фінальний video.url у власне сховище, якщо він потрібен вам після завершення тимчасового вікна доставки від провайдера.

Що змінюється в 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.

model
string
за замовчуванням:grok-imagine-video

xAI video model id.

Приклад:

"grok-imagine-video"

output
object
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.