Grok Imagine 1.5 API: превращаем изображение в короткое видео

Одно продуктовое фото, портрет человека или статичный пейзаж — и без входа в другой аккаунт для генерации видео можно получить готовый короткий видеоклип. Эндпоинт image-to-video в Grok Imagine 1.5 принимает URL изображения, необязательный промпт с описанием движения и длительность, а затем возвращает отрендеренный файл .mp4 через асинхронный API задач hiapi.

В этом разборе мы используем одно и то же исходное изображение и два разных промпта, чтобы показать, насколько сильно формулировка влияет на результат, а затем разберём фактическую схему запроса, ценообразование и приведём готовые к копированию примеры кода.

Исходное изображение

Оба клипа ниже начинаются с этого же статичного кадра. Между двумя запросами базовое изображение не меняется — различается только поле prompt.

Вариант 1: короткий тизерный наезд

Промпт: «Slow push-in toward the subject, soft ambient light, cinematic teaser pacing.» Длительность: 4.

Вариант 2: более длинный облёт камеры

Промпт: «Camera slowly orbits around the subject, revealing the scene from a new angle.» Длительность: 8.

Один и тот же статичный кадр, одна и та же модель, два совершенно разных движения камеры — здесь почти всё решает промпт, поскольку в запросе нет отдельных параметров интенсивности движения или траектории камеры.

Фактическая схема запроса

Полная документация модели и актуальные цены — на странице модели Grok Imagine 1.5 Image-to-Video. Тело запроса намеренно сделано компактным:

{
  "model": "grok-imagine-1.5/image-to-video",
  "input": {
    "image_urls": ["https://your-public-host.com/source.jpg"],
    "prompt": "Slow push-in toward the subject, soft ambient light, cinematic teaser pacing.",
    "duration": 4
  }
}

Перед вызовом нужно знать три вещи:

• image_urls должен быть публичным HTTP(S)-URL. Модель сама загружает изображение — вы не можете передать сырые байты в теле запроса. Если исходное изображение есть только локально, сначала загрузите его в любое публичное хранилище.
• duration — целое число от 1 до 15 секунд. Полей aspect_ratio, resolution или интенсивности движения нет — композиция выходного видео следует за исходным изображением, а разрешение определяется тарифным уровнем (480p или 720p), а не параметрами запроса.
• prompt необязателен, но выполняет большую часть творческой работы, поскольку больше ничто не управляет камерой.

Отправка задачи и опрос статуса

Как и все видеомодели и модели изображений на hiapi, эта модель работает через унифицированный асинхронный API задач, а не через синхронный эндпоинт — генерация требует реального времени, поэтому нужно отправить задачу, опрашивать статус завершения, а затем скачать результат до истечения срока действия ссылки.

# 1. Submit the task
curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5/image-to-video",
    "input": {
      "image_urls": ["https://your-public-host.com/source.jpg"],
      "prompt": "Camera slowly orbits around the subject, revealing the scene from a new angle.",
      "duration": 8
    }
  }'
# => {"id": "task_...", "status": "pending"}

# 2. Poll until it's done
curl -s https://api.hiapi.ai/v1/tasks/task_... \
  -H "Authorization: Bearer $HIAPI_API_KEY"
# => {"id": "task_...", "status": "success", "output": [{"url": "https://...mp4"}]}

Как только status станет success, сразу скачивайте output[0].url — это временная ссылка, а не постоянная, поэтому сохраните байты в собственное хранилище до истечения срока её действия.

Ценообразование и расчёт по длительности

Перед бюджетированием пакетных задач сверьте актуальные цифры на странице цен hiapi, но на момент написания статьи grok-imagine-1.5/image-to-video тарифицируется посекундно по длительности выходного видео:

Разрешение	Цена за секунду
480p	$0.015
720p	$0.0282

Клип длительностью 4 секунды в 480p стоит $0.06; тот же клип в 720p — около $0.11. Поскольку цена масштабируется по длительности, а не по фиксированной ставке за генерацию, тестировать несколько вариантов промпта на одном статичном кадре перед финальным монтажом дёшево — два клипа из этой статьи вместе стоят значительно меньше $0.20.

Частые вопросы

Можно ли управлять движением камеры напрямую, а не описывать его в промпте? Нет — в схеме этого эндпоинта нет отдельных параметров интенсивности движения, траектории камеры или масштабирования. Поведение камеры полностью определяется тем, как вы сформулируете prompt.

Будет ли выходное разрешение соответствовать исходному изображению? Композиция следует за соотношением сторон исходного изображения, но разрешение (480p или 720p) определяется выбором тарифного уровня, а не отдельным полем — проверяйте актуальную схему на странице модели по ссылке выше, поскольку платформенные модели иногда добавляют параметры.

Что будет, если я не успею скачать результат? output[0].url завершённой задачи является временной. Если пропустить окно, придётся повторно отправить задачу и снова оплатить генерацию — восстановить истёкшую ссылку невозможно.

Можно ли анимировать несколько статичных кадров в одном запросе? image_urls принимает один URL, но каждая задача создаёт один клип из одного исходного изображения. Для пакетной обработки отправляйте отдельную задачу на каждый статичный кадр и опрашивайте их по отдельности — асинхронная модель позволяет вести несколько задач одновременно.

---

Готовы попробовать на собственных изображениях? Сгенерируйте короткий клип со своим промптом на странице модели Grok Imagine 1.5 Image-to-Video, а если вы подключаете её к существующему пайплайну, начните с документации асинхронного API задач.