xAI
Grok Imagine
grok-imagine/image-to-video
Творческая модель генерации от xAI с поддержкой редактирования изображений по изображению и стилевого управления, до 9 референсных изображений для контроля композиции и персонажей; вызывается через единый интерфейс HiAPI.ai
Попробовать grok-imagine/image-to-video
Ввод
Работы
Все работыВывод
videoЦены
grok-imagine/image-to-video per second
| Характеристики | Цена за единицу |
|---|---|
| 480P | $0.0114 |
| 720P | $0.0214 |
| 1080P | $0.05714 |
Краткое описание
grok-imagine/image-to-video — это модель преобразования изображения в видео из семейства grok-imagine от xAI, доступная через единый интерфейс HiAPI.ai. Она принимает одно или несколько референсных изображений вместе с текстовым запросом и превращает статичный кадр в динамичный видеоролик, поддерживая длительность 6–30 секунд, разрешение от 480p до 1080p и различные соотношения сторон. Подходит разработчикам и креативным командам, которым нужно быстро анимировать иллюстрации, раскадровки или изображения продуктов — для создания контента для соцсетей, прототипов рекламы и предварительного просмотра динамичных кадров.
Ключевые преимущества
- Управление движением с помощью нескольких изображений — можно передать до 7 референсных изображений и ссылаться на них в запросе через @image1 и т. п., что позволяет точно контролировать субъект и композицию.
- Переключаемые стили движения — доступны три режима генерации: fun, normal и spicy, которые соответствуют более креативному, сбалансированному и более динамичному движению.
- Гибкий выбор длительности и разрешения — длительность задаётся в диапазоне от 6 до 30 секунд, разрешение — от 480p до 1080p, что позволяет балансировать между скоростью генерации и качеством итогового видео.
- Прозрачная тарификация — оплата рассчитывается по количеству выходных секунд, а параметр длительности напрямую определяет стоимость вызова, что упрощает оценку бюджета перед пакетной генерацией.
Описание возможностей
Генерация видео на основе референсных изображений: на вход подаются от 1 до 7 изображений в формате JPEG, PNG или WEBP; модель создаёт динамичный кадр, сохраняя субъект и композицию, что подходит для превращения статичных материалов в видеофрагменты.
Управление движением через текстовый запрос: опционально можно передать запрос длиной до 5000 символов с описанием желаемого движения; лучше описывать на английском, чтобы помочь модели сосредоточиться на заданных действиях и направлении камеры.
Вывод в нескольких соотношениях сторон: поддерживаются пять пропорций — 2:3, 3:2, 1:1, 16:9 и 9:16; они действуют в режиме с несколькими референсными изображениями и позволяют сразу закрыть потребности как в горизонтальном, так и в вертикальном формате.
Настраиваемые разрешение и длительность: выходное разрешение по умолчанию — 480p, его можно повысить до 720p или 1080p; длительность по умолчанию — 6 секунд, максимум — 30 секунд; оплата взимается за фактически сгенерированные секунды.
Сценарии применения
- Дизайнеры анимируют статичные иллюстрации в динамичные кадры — в качестве входных данных используется иллюстрация или раскадровка с кратким описанием движения, на выходе получается короткий видеокадр для анимированных постеров, заставок и предварительного просмотра раскадровок.
- E-commerce команды создают динамичную демонстрацию из изображений продуктов — загрузите изображение продукта и опишите движение камеры, чтобы получить вертикальное или квадратное короткое видео, которое можно напрямую использовать на страницах товаров и в рекламных лентах соцсетей.
- Контент-креаторы массово производят материалы для соцсетей — пакетная генерация динамичных материалов в пропорции 9:16 и с небольшой длительностью для ежедневного обновления контента и тестирования идей на платформах коротких видео.
Ограничения и рекомендации по выбору
Модель работает только с изображениями в качестве входа и не принимает чисто текстовые запросы для генерации видео — требуется хотя бы одно референсное изображение. При вводе одного изображения параметр соотношения сторон не действует, и выходное видео следует пропорциям исходного изображения; разрешение 1080p поддерживается только при вводе одного изображения. При использовании внешних изображений режим генерации может быть автоматически понижен до normal. Если требуется генерировать видео напрямую из текста или нужен непрерывный длинный кадр длительнее 30 секунд, следует выбрать другую модель или генерировать видео по частям. Стоимость растёт с длительностью, поэтому перед пакетными вызовами с большой длительностью рекомендуется сначала провести пробную проверку на небольшом примере.
Новости
Смотреть changelog →- Новая модель Новые модели: grok-imagine-image-2.0/text-to-image и grok-imagine-ima…
Частые вопросы
Все частые вопросы →-
Для чего подходит стандартный уровень Grok Imagine?
Подходит для массового исследования идей, материалов для социальных сетей, пейзажных и кинематографичных сцен. 1k и 2k сейчас стоят одинаково, поэтому лучше сразу выбирать более высокий уровень вывода.
-
В чём разница между стандартным тарифом и тарифом Quality?
Стандартный тариф делает акцент на скорости и фиксированной низкой цене; Quality — это отдельная линейка моделей, которая уделяет больше внимания материалам, деталям и освещению, а оплата тарифицируется по уровням 1k/2k.
-
Какие форматы изображения поддерживаются?
Поддерживается 13 форматов: горизонтальные, квадратные и вертикальные — от 2:1 и 20:9 до 1:2.
-
Поддерживает ли эта страница референсное изображение?
Нет. Для редактирования по референсному изображению используйте grok-imagine/image-to-image.
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: grok-imagine/image-to-video
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для grok-imagine/image-to-video и маршрута default — см. таблицу параметров ниже.
modestringНеобязательноПо умолчанию: "normal"Режим генерации, влияет на стиль и интенсивность движения в видео; строковое значение, по умолчанию normal. При передаче внешних изображений (image_urls) вышестоящий сервис может автоматически переключиться на normal.
funnormalspicypromptstringНеобязательноmaxLength 5000Текстовый промпт с описанием желаемого движения в видео, необязательный, лучше всего работает на английском, максимум 5000 символов.
durationintegerНеобязательноПо умолчанию: 6min 6max 30Длительность видео в секундах, целое значение, по умолчанию 6. Стоимость рассчитывается по секундам.
image_urlsarrayОбязательноminItems 1maxItems 7Массив референсных изображений, элементы — URL изображений или идентификаторы ресурсов asset://, максимум 7 штук; поддерживаются JPEG/PNG/WEBP, каждое не более 10MB. В промпте можно ссылаться на конкретные изображения через @image1 и т. п.
Array [ string ]
resolutionstringНеобязательноПо умолчанию: "480p"Разрешение выходного видео, строковое значение, по умолчанию 480p. 1080p поддерживается только при одном входном изображении.
480p720p1080paspect_ratiostringНеобязательноПо умолчанию: "2:3"Соотношение сторон выходного видео, строковое значение, по умолчанию 2:3. Действует только в режиме мультиреференса; при вводе одного изображения параметр не действует, и выходное видео наследует пропорции входного изображения.
2:33:21:116:99:16callbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine/image-to-video",
"input": {
"mode": "normal",
"duration": 6,
"image_urls": "…",
"resolution": "480p",
"aspect_ratio": "2:3"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "grok-imagine/image-to-video",
input: {
"mode": "normal",
"duration": 6,
"image_urls": "…",
"resolution": "480p",
"aspect_ratio": "2:3"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "grok-imagine/image-to-video",
"input": {
"mode": "normal",
"duration": 6,
"image_urls": "…",
"resolution": "480p",
"aspect_ratio": "2:3"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Сравнительный обзор
hailuo-2.3-fast/image-to-video — горизонтальное сравнение: как выбрать модель «изображение в видео» и что учесть при миграции
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
-
Руководство
Практика генерации изображений по тексту с recraft-v4.1-flash: 5 ценных бизнес-сценариев и ключевые моменты интеграции
Отталкиваясь от стоимости $0.01 за изображение, спланируйте внедрение генерации изображений в реальные бизнес-процессы
-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
-
Сравнительный обзор
Recraft v4.1 Flash 文生图横向对比:开发者选型与迁移指南
用每张 $0.01 的成本与纯文生图能力,判断它是否适合你的图像生成流水线
-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
Похожие модели
Все модели →Тот же тип
-
PixVerse V6 PixVerse $0.036 /секунду -
Wan 3.0 Video Alibaba $0.040 /секунду -
HappyHorse 1.1 Alibaba $0.160 /секунду -
Vidu Q4 Preview Vidu $0.051 /секунду -
Wan 2.7 Video Alibaba $0.100 /секунду -
Gemini Omni Google -- -
Grok Imagine 1.5 xAI $0.011 /секунду -
FLUX 3 Video Black Forest Labs $0.090 /секунду -
Grok Imagine 1.5 Lite xAI $0.029 /секунду -
Gemini Omni 1.1 Flash Google $0.450 /видео -
Kling 2.5 Kuaishou $0.060 /секунду -
Ray 3.2 Luma $0.214 /видео


