Grok Video API

На этой странице описан вызов видеомоделей Grok от xAI — grok-imagine-video и grok-imagine-video-1.5. Как и другие видеомодели, они создаются через POST /v1/videos и опрашиваются через GET /v1/videos/{id}; аутентификация, статусы опроса, скачивание результатов и обработка ошибок описаны в полной спецификации Video API. Здесь приведены только поля и правила, специфичные для Grok.

Обновлено 2026-10-10. Прежняя grok-imagine-video-1.5-1080p снята с публикации: для 1080P используйте grok-imagine-video-1.5 с "resolution": "1080p". Grok задаёт соотношение сторон через aspect_ratio (или ratio, size). Grok поддерживает только опрос; не указывайте callback_url.

Модели

Параметры

• Разрешение: resolution принимает 480p и 720p, а для grok-imagine-video-1.5 также 1080p. Можно указать и в metadata.resolution.
• Длительность: целое число секунд от 1 до 15 в duration (или строкой в seconds).
• Соотношение сторон: aspect_ratio и ratio равнозначны; соотношение можно также указать в size (например, "size": "9:16"). size не принимает размеры в пикселях. Если передано несколько полей соотношения сторон (включая поля в metadata), их значения должны совпадать, иначе вернётся 400.
• Изображение: не более одного, публичный URL https://, в images, image или input_reference. Одно и то же изображение, указанное в двух полях, считается за 2 и вернёт 400.
• Промпт: при наличии изображения prompt можно опустить; если нет ни того, ни другого, вернётся 400.
• Не поддерживается: первый и последний кадр, референсное видео, референсное аудио, negative_prompt, seed, generate_audio, загрузка файлов через multipart/form-data.

Текст в видео

{
  "model": "grok-imagine-video-1.5",
  "prompt": "Серебристый спорткар в дождливом ночном городе, съёмка с низкой точки в движении, отражения неона, кинематографично",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p"
}

Изображение в видео

{
  "model": "grok-imagine-video",
  "prompt": "Сохранить объект с референсного изображения, камера медленно отъезжает от крупного плана, кинематографично",
  "duration": 6,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "images": ["https://cdn.example.com/start.jpg"]
}