Как использовать API Grok Imagine 1.5 Lite для преобразования изображения в видео? Оживите фото

TL;DR

• Grok Imagine 1.5 Lite Image to Video (grok-imagine-1.5-lite/image-to-video) загружает 1 изображение и оживляет его: 1–15 секунд, встроенный звук, соотношение сторон следует за входным изображением. Откройте страницу модели, загрузите одно изображение и попробуйте — новым пользователям при регистрации дают 200 кредитов.
• Цена = цена за секунду × количество секунд + $0.015 за входное изображение для каждого запроса: 720P 6 секунд — $0.273; 480P — $0.189; 1080P — $1.215.
• Вызов идёт через интерфейс HiAPI /v1/tasks: image_url — это строка (не массив), ровно 1 публичный адрес.

Что он умеет

• Превращает фотографию в кадр со звуком: движение, работа камеры и звуковые эффекты описываются в промпте, а主体 изображения сохраняется.
• Соотношение сторон следует за входным изображением: горизонтальное изображение даёт 16:9 (1264×720), вертикальное — 9:16 (720×1264), квадратное — 1:1 (960×960), 4:3 — 1104×816; пиксели округляются до поддерживаемого размера, пропорции не меняются.
• Любое целое число секунд от 1 до 15, три уровня разрешения.
• Текст-в-видео из той же серии: генерация с нуля описана в руководстве по подключению текст-в-видео; оба интерфейса стоят одинаково (в изображение-в-видео добавляется $0.015 за входное изображение), используют один /v1/tasks, в коде отличаются только model и image_url.

Как читать таблицу цен:

• «цена за секунду × количество секунд» — это стоимость самого видео, она полностью совпадает с текст-в-видео;
• $0.015 — дополнительная плата за входное изображение, фиксированная для каждого запроса, не зависит от разрешения и длительности;
• Поэтому при одинаковых параметрах изображение-в-видео дороже текст-в-видео на $0.015: 720P 6 секунд $0.258 + $0.015 = $0.273. При пакете из тысячи запросов эта разница составит $15 — её нужно заложить в бюджет.

Ниже реальный результат (фото сёрфинга → 6-секундный следящий кадр со звуком волн):

The wave curls and breaks behind the surfer as he carves down its face, white spray bursts and sparkles in the golden backlight, water rushes past. Smooth tracking camera following the surfer. Loud ocean surf and rushing water. Keep the photo realistic. No text, no logos.

(По-русски: волна закручивается и разбивается за сёрфером, пока он скользит по её поверхности, белые брызги вспыхивают и сверкают в золотом контровом свете. Камера плавно следит за сёрфером. Громкий шум океанского прибоя и воды. Сохраняйте фотореалистичность. Без текста, без логотипов.)

·

grok-imagine-1.5-lite/image-to-video, 720P, 6 секунд, 16:9, 1264×720, встроенный звук, $0.273 (включая $0.015 за входное изображение).Смотреть полное видео →

Сгенерировать с этим промптом →

Цена: цена за секунду + плата за входное изображение

Уровень	За секунду	6 секунд за запрос (включая $0.015 за входное изображение)
480P	$0.029	$0.189
720P (по умолчанию)	$0.043	$0.273
1080P	$0.20	$1.215

Текущие цены HiAPI, проверено 23 октября 2026 г. image_url обязателен, поэтому в каждом запросе есть эти $0.015; 1080P стоит $0.2 за секунду (примерно в 4,65 раза дороже 720P), для массовых экспериментов используйте 480P. При неудаче плата не взимается.

Два способа начать

3 шага в браузере: откройте страницу модели → загрузите изображение, опишите движение → нажмите «Сгенерировать».

3 шага через API: POST /v1/tasks отправить → получить taskId → GET /v1/tasks/<taskId> дождаться success и скачать.

curl: первый запрос

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "model": "grok-imagine-1.5-lite/image-to-video",
  "input": {
    "prompt": "The wave curls and breaks behind the surfer as he carves down its face, white spray bursts and sparkles in the golden backlight, water rushes past. Smooth tracking camera following the surfer. Loud ocean surf and rushing water. Keep the photo realistic. No text, no logos.",
    "image_url": "https://static.hiapi.ai/gallery/2026/10/3f75ff28db9e0070.png",
    "duration": 6,
    "resolution": "720p"
  }
}'

Обратите внимание: image_url — строка, передаётся только одно изображение — массив вызовет 400.

Python: отправка, опрос, скачивание

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "model": "grok-imagine-1.5-lite/image-to-video",
    "input": {
        "prompt": "The wave curls and breaks behind the surfer as he carves down its face, white spray bursts and sparkles in the golden backlight, water rushes past. Smooth tracking camera following the surfer. Loud ocean surf and rushing water. Keep the photo realistic. No text, no logos.",
        "image_url": "https://example.com/your-image.png",
        "duration": 6,
        "resolution": "720p",
    },
}

resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    video = next(o for o in task["output"] if o.get("type") == "video")
    mp4 = requests.get(video["url"], timeout=120)   # временный адрес, сохраните как можно скорее
    with open("output.mp4", "wb") as f:
        f.write(mp4.content)
    print("saved output.mp4")

Таблица параметров

Поле	Обязательно	Значение	Описание
image_url	Да	Строка, ровно 1 публичный адрес	Пропорции выходного видео следуют за этим изображением
prompt	Да	1–4096 символов	Опишите желаемое движение или изменение, включая звуковые эффекты
duration	Нет	Любое целое число 1–15, по умолчанию 6
resolution	Нет	480p / 720p / 1080p, по умолчанию 720p

Поля, отсутствующие в таблице, в теле запроса приводят к 400.

Ошибки, которые вы встретите

Код состояния	Значение	Что делать
400 INVALID_REQUEST	Некорректное тело запроса (отсутствует image_url, image_url передан массивом, переданы поля не из таблицы)	Используйте image_url как строку
402 INSUFFICIENT_QUOTA	Недостаточно средств (плата не взимается)	Пополните баланс и повторите
429 RATE_LIMITED	Сработало ограничение частоты	Снизьте частоту отправки
409 / 422 IDEMPOTENCY_KEY_*	Повторная отправка с тем же ключом идемпотентности	Используйте новый Idempotency-Key

При неудачном завершении задачи возможны также CONTENT_POLICY_VIOLATION, TASK_FAILED, TASK_TIMEOUT и др.; при неудаче плата не взимается.

Перед запуском в продакшен

• Callback: видеозадачи выполняются долго, передайте на верхнем уровне "callback": {"url": "https://..."}, чтобы избежать опроса.
• Своевременно сохраняйте: адрес видео в output временный — скачайте и сохраните в своё хранилище, не используйте временную ссылку как библиотеку материалов.
• Одно и то же изображение можно использовать многократно: новый промпт — новый запрос (новая оплата), особенно удобно для быстрого создания целого набора демонстрационных материалов с разными ракурсами движения из одного продуктового фото.
• Не забудьте $0.015 в расчётах: бюджет пакета считайте по формуле «цена за секунду × количество секунд + $0.015 × количество запросов».
• Звук нельзя отключить: для материалов без звука вырезайте его при постобработке; цена не меняется.

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

• Да, каждый запрос содержит встроенный звук: звуковые эффекты, описанные в промпте (волны, хруст снега), будут сгенерированы, выключателя нет.
• Да, соотношение сторон следует за входным изображением: изображение 16:9 даёт 1264×720, квадратное — 960×960, пиксели округляются, пропорции не меняются.
• Да, image_url — строка, только 1 изображение; массив или несколько изображений вызовут 400.
• Да, длительность — любое целое число секунд от 1 до 15: одно действие 5–6 секунд, непрерывное действие — 10 секунд и больше.
• Да, качество входного изображения определяет верхнюю границу результата: размытое маленькое изображение при оживлении не станет чётким; по возможности давайте чёткое исходное изображение от 720p.
• Да, для пакетных расчётов есть формула: цена за секунду × количество секунд + $0.015 × количество запросов; 720P 6 секунд сто запросов — $27.30, тысяча — $273.00.

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