Створення відео за допомогою Grok

POST

grok

videos

generations

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A paper boat glides across a quiet pond at sunrise.",
  "duration": 1,
  "aspect_ratio": "16:9",
  "resolution": "480p"
}'

{
  "request_id": "<request_id>"
}

Використовуйте цей endpoint, щоб запустити завдання відео Grok із тексту, вихідного зображення або вхідних посилань. Він одразу повертає request_id, тому вважайте це першим кроком асинхронного робочого процесу. Завжди явно надсилайте model: grok-imagine-video-1.5. Для описаних тут форм запитів версії 1.5 обов’язкові model і prompt.

Виберіть режим введення

Режим	Поля запиту	Правила
Текст у відео	`prompt`	Не вказуйте `image`, `reference_images` і `reference_audios`.
Зображення у відео	`prompt`, `image.url`	`image.url` приймає публічний URL-адрес зображення або URI даних зображення. Не поєднуйте `image` із вхідними посиланнями.
Посилання у відео	`prompt` і щонайменше один із `reference_images` або `reference_audios`	Надсилайте до 7 зображень-посилань і до 3 попередньо налаштованих голосів. Вивід «посилання у відео» обмежено `720p`.

Для URI даних використовуйте data:image/png;base64,<BASE64_IMAGE_DATA>. Кожен елемент reference_images використовує те саме поле url. Елемент аудіопосилання використовує попередньо налаштований voice_id, наприклад eve. У Prompt теги, як-от <IMAGE_0> і <AUDIO_0>, можуть позначати відповідне посилання.

Почніть із невеликого запиту

Використовуйте model: grok-imagine-video-1.5
Для першого запиту встановіть duration на 1, а resolution — на 480p
Явно вказуйте prompt, щоб сцена та рух були зрозумілими
Додавайте по одному режиму введення, перш ніж поєднувати зображення-посилання та голоси

Тривалість і роздільна здатність

Налаштування	Підтримувані значення	За замовчуванням	Поведінка на межах
`duration`	ціле число `1`-`15`	`8`	Для перших тестів використовуйте коротші кліпи; довші кліпи коштують більше та потребують більше часу для завершення.
`resolution`	`480p`, `720p`, `1080p`	`480p`	Запити з вищою роздільною здатністю коштують більше та потребують більше часу для завершення. Режим «посилання у відео» підтримує до `720p`.
`aspect_ratio`	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	`16:9` для режиму «текст у відео»	Для режиму «зображення у відео» пропуск параметра зберігає співвідношення сторін вихідного зображення.

Згенеровані відео містять аудіодоріжку. Явно встановлюйте duration, resolution і aspect_ratio, коли ваш застосунок залежить від певної форми виводу.

Потік завдання

Створіть завдання

Надішліть модель, Prompt і будь-які входи, а потім збережіть повернений request_id.

Опитуйте статус до завершення

Викликайте Отримання результатів відео xAI доки status верхнього рівня не набуде значення done, failed або expired. Початкова відповідь може містити лише віддзеркалений request_id, поки готуються метадані завдання.

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

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

Авторизації

Authorization

string

header

обов'язково

Use your CometAPI API key as the bearer value.

Тіло

application/json

model

enum<string>

обов'язково

The Grok video model ID. Send this field explicitly so the request uses Grok Imagine Video 1.5.

Доступні опції:

grok-imagine-video-1.5

Приклад:

"grok-imagine-video-1.5"

prompt

string

обов'язково

A description of the scene, motion, and audio. Reference-to-video prompts can identify inputs with tags such as <IMAGE_0> and <AUDIO_0>.

Minimum string length: 1

Приклад:

"A paper boat glides across a quiet pond at sunrise."

duration

integer

за замовчуванням:8

The output duration in seconds. Use an integer from 1 through 15.

Необхідний діапазон: 1 <= x <= 15

aspect_ratio

enum<string>

The output aspect ratio. Text-to-video uses 16:9 when omitted. Image-to-video uses the source image's aspect ratio when omitted.

Доступні опції:

1:1,

16:9,

9:16,

4:3,

3:4,

3:2,

2:3

Приклад:

"16:9"

resolution

enum<string>

за замовчуванням:480p

The output resolution. Reference-to-video requests support 480p and 720p; text-to-video and image-to-video also support 1080p.

Доступні опції:

480p,

720p,

1080p

image

object

The source image for image-to-video. Do not combine this field with reference_images or reference_audios.

Show child attributes

reference_images

object[]

Visual references for reference-to-video. Each item accepts a public image URL or image data URI. Do not combine this field with image.

Required array length: 1 - 7 elements

Show child attributes

reference_audios

object[]

Preset voice references for reference-to-video. Do not combine this field with image.

Required array length: 1 - 3 elements

Show child attributes

Відповідь

200 - application/json

Request accepted.

request_id

string

обов'язково

The deferred request ID used to poll GET /grok/v1/videos/{request_id}.

Останнє оновлення 21 серпня 2026 р.

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A paper boat glides across a quiet pond at sunrise.",
  "duration": 1,
  "aspect_ratio": "16:9",
  "resolution": "480p"
}'

{
  "request_id": "<request_id>"
}

Модерація контенту

API-ключі

Створення відео за допомогою Grok

Виберіть режим введення

Почніть із невеликого запиту

Тривалість і роздільна здатність

Потік завдання

Авторизації

Тіло

Відповідь

​Виберіть режим введення

​Почніть із невеликого запиту

​Тривалість і роздільна здатність

​Потік завдання

Авторизації

Тіло

Відповідь

Виберіть режим введення

Почніть із невеликого запиту

Тривалість і роздільна здатність

Потік завдання