Grok Video API

Grok Video создаёт короткие ролики по тексту или оживляет загруженные изображения. Публичная страница и форма остаются прежними, а provider-ready payload собирается сервером автоматически.

Создание операции

POST /api/operations/create

В toolSlug передавайте grok-video. Данные формы передаются в input по публичному контракту ниже.

Тело запроса

{
  "toolSlug": "grok-video",
  "input": {
    "model": "grok-imagine/image-to-video",
    "input": {
      "prompt": "Плавный пролёт камеры вокруг персонажа, волосы развеваются на ветру",
      "image_urls": ["https://example.com/start-frame.png"],
      "duration": 10,
      "resolution": "720p",
      "mode": "normal"
    }
  }
}

Параметры

Параметр	Тип	Обязательный	Описание
model	string	да	Тип генерации: grok-imagine/image-to-video или grok-imagine/text-to-video.
input.prompt	string	да	Задание для видео. Максимум 5000 символов.
input.image_urls	string[]	да, для image-to-video	От 1 до 7 изображений. Поддерживаются JPG, JPEG, PNG, WebP, HEIC, HEIF.
input.aspect_ratio	string	да, для text-to-video	Соотношение сторон: 16:9, 9:16, 1:1, 3:2, 2:3.
input.duration	integer	да	Длительность видео в секундах: от 6 до 30.
input.resolution	string	да	Разрешение: 480p или 720p.
input.mode	string	да	Значение формы для совместимости edit/repeat: normal, fun, spicy. Сохраняется в form_data, но не отправляется во внешний provider payload.

Provider Payload

После валидации сервер преобразует данные формы в APIMart body.

Видео из текста

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "Космический корабль пролетает сквозь туманность, кинематографично, мягкое свечение",
  "size": "16:9",
  "duration": 6,
  "quality": "480p"
}

Видео из изображений

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "Добавь естественное движение камеры и живую мимику",
  "image_urls": ["https://example.com/start-frame.png"],
  "duration": 10,
  "quality": "720p"
}

Правила:

• input.aspect_ratio преобразуется в size.
• input.resolution преобразуется в quality.
• input.mode в provider payload не передаётся.
• Для text-to-video поле image_urls удаляется.
• Для image-to-video поле size не отправляется.

Ценообразование

• 480p - 2 ₽/сек
• 720p - 3 ₽/сек

Минимальная стоимость операции при длительности 6 секунд:

• 480p - 12 ₽
• 720p - 18 ₽

Результат

Результат операции возвращается в стандартном формате платформы:

{
  "type": "video",
  "urls": ["https://storage.yandexcloud.net/.../result.mp4"]
}