grok-imagine-video

Grok Imagine Video создаёт короткие ролики по текстовому описанию с выбором длительности и формата кадра. Сама модель xAI также поддерживает анимацию изображения и направленное редактирование видео.

Ailoot · Видео POST /v1/videos/generations grok-imagine-video

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

От описания к ролику

Grok Imagine Video создаёт видео по тексту. У самой модели xAI есть также режимы с исходным изображением и видео. В опубликованном методе генерации Ailoot входом служит текстовое описание, а результатом — ролик.

Генерация выполняется асинхронно: сначала создаётся задача, затем по её идентификатору получается состояние и готовый результат. По данным xAI, создание ролика может занимать несколько минут; время зависит от сложности сцены, длительности, разрешения и выбранного режима.

Длительность и кадр

Для создания ролика доступна длительность от 1 до 15 секунд. Форматы кадра включают 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 и 2:3; стандартный формат — 16:9. У этой версии предусмотрены 480p и 720p, а 1080p относится к версии 1.5.

Анимация исходного изображения

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

Направленное редактирование

При работе с готовым видео модель применяет описанные изменения, сохраняя остальное содержимое сцены. Этот режим помогает изменить нужный элемент, сохранив постановку исходного ролика. Длительность и пропорции наследуются от оригинала; новая длительность или форма кадра не задаются.

Исходный ролик для редактирования ограничен 8,7 секунды, а результат — разрешением не выше 720p. Материал в 1080p уменьшается до 720p. Настройки генерации по тексту не переносятся автоматически на редактирование.

Продолжение готового ролика

В отдельном режиме xAI эта версия продолжает исходный ролик с его последнего кадра. Исходный MP4 должен длиться от 2 до 15 секунд; добавляемая часть — от 2 до 10 секунд, по умолчанию 6. Результат объединяет исходное видео и продолжение. Пропорции и разрешение наследуются от исходника, с пределом 720p; отдельно менять их в этом режиме нельзя. Эта возможность производителя отличается от опубликованной генерации Ailoot по тексту.

Референсы и границы версии

xAI предусматривает использование визуальных референсов, чтобы направлять внешний вид людей, одежды и предметов в сцене. Референс задаёт визуальные признаки, а не точное изображение первого кадра. Для классической Grok Imagine Video нельзя соединять начальный кадр с референсами.

Эта версия не принимает точную фиксацию последнего кадра и промежуточные ключевые кадры. Такие возможности принадлежат Grok Imagine Video 1.5. Генерация, анимация исходной картинки и изменение готового ролика — разные режимы; опубликованный метод Ailoot здесь описывает генерацию по тексту.

Ailoot · Видео POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Начало

Допустимые входные данные: Текст
Результаты: Видео

Доступно в Ailoot · входные данные и методы

Ailoot · Видео POST /v1/videos/generations

Входные данные: text
Результат: video
Выходной формат: mp4

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения grok-imagine-video	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения Минимальная длина: 1	По умолчанию—
Поле`duration`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения Минимум: 1 Максимум: 15 Условия: Не передавайте duration и seconds одновременно Единица: секунды	По умолчанию1
Поле`seconds`	Тип`integer\|integer_string`	ТребованиеНеобязательно	Значения и ограничения Минимум: 1 Максимум: 15 Альтернатива: duration	По умолчанию—
Поле`resolution`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 480p, 720p	По умолчанию480p
Поле`aspect_ratio`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Условия: Если передано входное изображение, а соотношение сторон не указано, поставщик использует соотношение сторон изображения	По умолчанию16:9
Поле`size`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1280x720, 720x1280, 1920x1080, 1080x1920 Условия: Должно соответствовать resolution/aspect_ratio, если указаны оба	По умолчанию—
Поле`image`	Тип`object`	ТребованиеНеобязательно	Значения и ограничения Условия: Фактическое поддерживаемое входное изображение; позволяет не передавать prompt	По умолчанию—

Сочетания входных материалов

Из текста в видео · Обязательно: prompt

Из изображения в видео · Обязательно: image

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`material_types`	Контрактtext
Параметр`required`	Контрактnull
Параметр`optional_controls`	Контрактnull

Жизненный цикл: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Структуры методов и ID указаны точно; возможности поставщика рассматриваются отдельно от допуска.

Тарифы

Ставки методов Ailoot

Ailoot ВидеоPOST /v1/videos/generations

Вход: 0,002 $ за входное изображение
Вход: 0,01 $ за секунду входного видео
Выход: 0,05 $ за секунду в 480p
Выход: 0,07 $ за секунду в 720p

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot · Видео

Пример видео

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

Получить и сохранить результаты

Ailoot · Видео

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Проверить статус задачи

GET статус

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

Чтение другого содержимого

GET содержимое

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

Сохраняйте все готовые результаты

Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.

Сохраните полный JSON статуса и фактический request_id. Завершённый ответ с status=done содержит video.url с URL содержимого, принадлежащим Ailoot. Сохраните указанную длительность и каждое возвращённое поле результата.

Если нужно проверить исходный ответ

Проверяйте существующую исходную задачу; никогда не повторяйте отправку с неизвестным исходом.

Поля ответа

Поле	Тип
Поле`request_id`	Типstring
Поле`id`	Типstring
Поле`status`	Типstring
Поле`video.url`	Типowned signed content URL
Поле`video.duration`	Типnumber
Поле`video.respect_moderation`	Типboolean

Ошибки и дальнейшие шаги

Ответ	Условие	Следующий шаг
Ответ400 · `invalid_request_error`	УсловиеНеверные обязательные поля, представление материалов или значение параметра	Следующий шагИсправьте указанные поля перед новым запросом на создание.
Ответ409 · `video_not_ready`	УсловиеСодержимое исходного результата пока недоступно	Следующий шагПроверяйте исходный возвращённый ID и соблюдайте Retry-After.
Ответ`server_error`	УсловиеВозвращённый ответ указывает, что операция или результат требуют проверки	Следующий шагСохраните исходный возвращённый ID операции или задачи, заголовки запроса и ответ; продолжайте поддерживаемые операции чтения исходной операции. Не отправляйте запрос создания повторно.

Псевдонимы

Псевдонимы моделей

Ailoot grok-imagine-video

Псевдонимы путей метода

Используйте пути методов, указанные выше.

Связанные ID для вызова

grok-imagine-video

FAQ · grok-imagine-video

Какие входные данные и результаты доступны?: POST /v1/videos/generations · grok-imagine-video: text → video
Какие поля использует запрос?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Какие ограничения действуют?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video