Введение
Передайте обязательный первый кадр и опишите движение; промежуточные ключевые кадры позволяют задать момент смены обстановки.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Видео |
| Издатель видео | xAI |
| Начальные материалы | Описание сцены; обязательный начальный кадр; либо 1–7 референсов |
| Предел описания | До 4 096 символов |
| Длина клипа | 1–15 секунд; исходно 6 секунд |
| Размер генерации и анимации | 480p (исходно), 720p, 1080p |
| Размер видео по референсам | 480p или 720p |
| Пропорции текстового видео | 16:9 (исходно), 9:16, 1:1, 4:3, 3:4, 3:2, 2:3; анимация также предлагает auto |
| Направление анимации | Обязательное начало; необязательный финал; до 4 keyframes по времени; 1 необязательный референс |
| Ограничение цикла | Первый и последний кадры совпадают; loop несовместим с |
| Создаваемый звук | Включён исходно; отключение не меняет тариф |
| Оплата видео | За секунду по разрешению; reference-to-video добавляет плату за каждый источник; ошибки бесплатны |
| Срок хранения видео | Созданные видеофайлы удаляются через 14 дней |
Ключевые возможности и особенности
Шёпот и видимый ответ
В баре на крыше в сумерках женщина в красном платье с открытой спиной наклоняется к мужчине и шепчет «Let's get out of here». Наш образец шесть секунд, 480p содержит реплику, затем его улыбку и взятие за руку. Назовите говорящего, текст и ответ второго; оценивайте речь и движение вместе.
Переправа с репликой
В тестах рыбацкая лодка пересекла фьорд на рассвете под кружащими чайками. Шестисекундный результат содержал звук и заданную реплику капитана.
Оранжерея на третьей секунде
В тесте дождливый переулок с фонарями сменился светлой викторианской оранжереей в заданные три секунды. Весь план длился шесть секунд со звуком.
Журавлик возвращается к началу
В тестах белый бумажный журавлик мягко качался на синем столе в четырёхсекундном цикле. Начальный и последний кадры совпали.
Танцовщица и бумажная птица в студии
В тесте танцовщица в чёрной репетиционной одежде медленно двигалась по белой студии, рядом парил журавлик. Два референса направляли шестисекундный результат 848x480.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите действие, обстановку и при необходимости реплики в кавычках — максимум 4 096 символов; длина текста не задаёт тариф. Не менее 1 символов · Не более 4096 символов |
image_url | Да | Обязательное изображение начального кадра анимации; оно задаёт начало и не образует отдельного ценового уровня. Не менее 1 символов |
last_image_url | Нет | При желании передайте финальный кадр; при включённом loop оставьте поле пустым, поскольку эти настройки несовместимы. Отдельного тарифа для этого поля нет. Не менее 1 символов |
reference_image_urls | Нет | Можно добавить одно изображение-референс и обозначить его в промпте как @image1; стоимость image-to-video зависит от секунд и разрешения. Не более 1 элементов |
aspect_ratio | Нет | Используйте auto для формы начального изображения либо 16:9, 9:16, 1:1, 4:3, 3:4, 3:2 или 2:3; общее значение по умолчанию — 16:9. Выбор не меняет тариф разрешения. |
keyframes | Нет | Передайте до четырёх промежуточных изображений с |
loop | Нет | Включите совпадение первого и последнего кадров для цикла; не передавайте одновременно |
resolution | Нет | Доступны 480p, 720p и 1080p; исходная настройка — 480p, повышение разрешения увеличивает посекундную цену. |
duration_seconds | Нет | Выберите длительность от 1 до 15 секунд; без настройки получится 6 секунд. Более длинный ролик увеличивает число оплачиваемых секунд. |
generate_audio | Нет | По умолчанию создаётся звук; его можно отключить, чтобы получить результат без звуковой дорожки. Цена за секунду сохранится. По умолчанию: |
Стоимость
Анимация изображений оплачивается за секунды результата по выбранному уровню разрешения; настройка звука не меняет тариф, ошибки не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.028 / секунду |
| $0.0505 / секунду |
| $0.09 / секунду |
Сценарии использования
Моменты истории с диалогом
Стройте короткое общение вокруг реплики и видимого ответа. Крыша сочетает шёпот-приглашение, улыбку и взятие за руку в шестисекундном звуковом клипе.
Переход с заданным прибытием
Направьте смену места промежуточной картинкой в выбранную секунду. Переулок достиг солнечной оранжереи на третьей секунде шестисекундного плана.
Повторяемое движение из кадра
Оживите начальное изображение с loop для возвращения к началу. Тест следовал совпадению кадров; до повторного размещения проверьте стык.
Сцены из визуальных референсов
Дайте отдельные картинки людей, реквизита и места, назначив каждой @image. Принимается один–семь источников с доплатой за каждый.
Немые вставки в готовый монтаж
Отключите аудио для последовательности с готовой дорожкой. Наш тест вернул отсутствие звука, а длительность и разрешение по-прежнему задают тариф.
Руководство по промптам и практические советы
Выберите источник сцены
Текст для письменного плана, image-to-video для обязательного начального кадра или reference-to-video для композиции нескольких источников.
Опишите действие и звук
Назовите героя, одежду, место, свет и посильное действие. Реплику заключите в кавычки, указав говорящего.
Настройте время и выход
Выберите 1–15 секунд, поддерживаемую форму и разрешение. Для анимации кадра при необходимости добавьте keyframes, финал либо цикл.
Проверьте и сохраните клип
Оцените движения, прослушайте речь, проверьте стык цикла или переход по времени. Успейте скачать выбранные клипы до удаления через 14 дней.
Движение из начального кадра
Image-to-video начинается с обязательного image_url и письменного движения. Grok Imagine Video 1.5 оживляет начало на 1–15 секунд со звуком. Выбирайте, когда важна исходная композиция, затем при необходимости добавьте визуальные цели конца или середины.
last_image_url даёт финал, keyframes — промежуточные картинки во времени, loop совмещает начало и конец. Один необязательный референс добавляет направление. Выбирайте по плану: у загруженных картинок разные задачи.
Карта параметров
| Параметр | Роль | Выбор или предел |
|---|---|---|
image_url | Начальный кадр | Обязателен |
| prompt | Движение, место и необязательный диалог | До 4 096 символов |
aspect_ratio | Форма выхода | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3; исходно 16:9 |
| resolution | Выходной уровень | 480p, 720p, 1080p; исходно 480p |
duration_seconds | Хронометраж | 1–15 секунд; исходно 6 |
generate_audio | Звуковая дорожка | Исходно включена |
last_image_url | Финальный кадр | Необязателен; несовместим с loop |
reference_image_urls | Дополнительный визуальный ориентир | Одна необязательная картинка, @image1 |
| keyframes | Промежуточные кадры в выбранные моменты | До 4, у каждого time_seconds |
| loop | Совпадение начала и конца | Не совмещать с last_image_url |
Для формы по начальной картинке выбирайте auto, иначе поддерживаемую под размещение. Слова о широком виде объясняют композицию, aspect_ratio выбирает форму.
Начало, середина и конец
Место в выбранную секунду
Keyframes нужны для прохождения конкретной картинки в конкретный момент. Дайте каждому промежуточному кадру time_seconds внутри длины. Тест перехода начинается дождливым переулком и достигает солнечной оранжереи на третьей секунде из шести.
В prompt опишите связь: движение камеры, смену света, раскрытие места назначения. Картинка по времени даёт визуальную цель по расписанию, но не заменяет движение между изображениями.
Прибытие или возвращение
Конечная картинка подходит для завершения на заданной композиции, loop — для возврата к исходной. Они несовместимы: решите финал до отправки.
Для цикла опишите ограниченное движение, например бумажный предмет качается и возвращается в позу. Просмотрите стык повтором. Тест следовал совпадению кадров, но выбранное действие всё равно нужно оценить в движении.
Промпт из готовой композиции
Начните с движущегося, затем направление и темп. Камеру добавьте отдельно для ясного действия героя. В предложенных сценах людей задавайте от тридцати лет, конкретизируя одежду, настроение и свет.
Портретное задание может попросить поворот к окну, улыбку и взгляд назад при сохранении вечернего платья и тёплого света начала. Необязательный референс назовите @image1 и объясните вклад. Используйте разрешённые фото и голоса совершеннолетних без имитации личности.
Диалог в кавычках может прозвучать в созданной дорожке. Для тишины отключите generate_audio: тест дал отсутствие звука. При принятии оценивайте звук вместе с движением.
Наблюдаемое поведение
Наши проверки подтвердили конечный кадр, loop и keyframes в соответствующих запросах. Переход достиг оранжереи на третьей секунде шестисекундного звукового плана. Это поддерживает конкретные настройки и показанный переход без гарантии любого движения между произвольными картинками.
После генерации сравните начало, нужную середину и конец с источниками. Оцените и промежутки движения, не только отдельные кадры.
Оплата и срок хранения
Цена зависит от длительности и разрешения: высокий уровень дороже за секунду. Отключение звука тариф не меняет, ошибки бесплатны. При выборе смотрите текущие цены модели. Сохраните принятое за 14 дней до удаления видео.
Ограничения и соседние сценарии
Фильтр издателя отклоняет отмеченное без платы. До четырёх промежуточных картинок; не передавайте финальную вместе с loop. Допустим один необязательный референс сверх начального кадра.
Без обязательного начала используйте text-to-video. Для нескольких визуальных источников — reference-to-video с одним–семью референсами и 480p/720p. Оставайтесь в image-to-video, если причина запроса — начало, прибытие по времени или цикл.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "xai/grok-imagine-video-1.5/image-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 6,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.











