Перейти к основному содержанию
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"
}

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, чтобы запустить задачу генерации видео 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.

Авторизации

​
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.