Создать видео

Создание видеозадачи Grok через API платформы Video Generations.

Поддерживаются генерация видео по тексту, по изображению и Video-to-Video Remix.

POST/v1/video/generations

Создавайте задачи генерации видео Grok по тексту, изображению или в режиме Video-to-Video Remix.

Пример ID модели — grok-imagine-video. В примерах используется MODEL_ID; фактическая доступность определяется списком моделей текущего ключа API.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

Запрос создания видео Grok.

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID видеомодели Grok, например grok-imagine-video. Фактическая доступность определяется списком моделей текущего ключа API.

Длина1 <= length

prompt*string

Описание желаемого генерируемого или перерисованного видео.

Длина1 <= length

duration?integer

Длительность видео в секундах, только для генерации по тексту или изображению. Диапазон — 1–15, по умолчанию 5. Remix не поддерживает это поле: длительность результата совпадает с входным видео и не превышает 8.7 секунды.

Диапазон1 <= value <= 15

По умолчанию5

images?array<string>

Список входных изображений для генерации видео по изображению. Используйте либо это поле, либо image.

image?string

Одно изображение для генерации видео: общедоступный URL или Base64 Data URI. Используйте либо это поле, либо images.

metadata?

Расширенные параметры, передаваемые вышестоящему сервису. Объект позволяет передавать дополнительные параметры Grok, например seed, negative_prompt и fps.

Платформа динамически рассчитывает расход квоты с учётом параметров запроса. Сохраняйте также metadata для сверки расходов и воспроизведения.

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Город в стиле киберпанк среди облаков",    "duration": 5,    "image": "https://example.com/init-frame.png",    "metadata": {      "resolution": "720p"    }  }'

{
  "id": "xai-task-12345"
}

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`