Grok Imagine video
Поддерживаются текст, первый кадр и референсные изображения. Входные видео, аудио и пары первого/последнего кадров не поддерживаются. Первый кадр и обычная референсная картинка имеют разную семантику; одного количества изображений недостаточно для выбора режима.
Модели и параметры
| Модель | Длительность | Разрешение | Референсные изображения |
|---|---|---|---|
grok-imagine-video | 1–15 секунд | 480p / 720p | Сейчас до 7 изображений, максимум 10 секунд |
grok-imagine-video-1.5 | 1–15 секунд | 480p / 720p / 1080p | Сейчас до 7 изображений, пресет до 15 секунд |
Соблюдайте ограничения выбранного режима. «≥7» в документации означает успешные примеры с как минимум семью изображениями, а не обязательный минимум или опубликованный жёсткий максимум. PopGo сейчас допускает 1–7 изображений.
Поля и режимы
| Поле | Тип | Правило |
|---|---|---|
model | string | Обязательный публичный ID модели из таблицы |
prompt | string | Обязательно; максимум 4096 байт UTF-8 |
seconds | integer | Целое число в пределах режима; в интерфейсе по умолчанию 8 секунд |
resolution | string | Зависит от модели; в интерфейсе по умолчанию 720p |
aspect_ratio | string | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3; по умолчанию 16:9; для первого кадра опускается |
input_reference | object | Ровно один первый кадр; объект с image_url |
reference_images | object[] | Референсы объекта/стиля; массив объектов с image_url |
Первый кадр задаёт начало сцены; референсы направляют объект, стиль и согласованность. Одна картинка тоже может быть обычным референсом. input_reference и reference_images взаимоисключающие. Не используйте image_url верхнего уровня: неверное поле может игнорироваться при продолжающейся генерации и списании.
Источники, пропорции и промпт
Документация описывает публичные URL и полные Data URL, но также фиксирует сбои загрузки публичных изображений после создания задачи. Текущий пресет Grok использует Base64: локальные файлы превращаются в полные data:image/...;base64,... значения. Публичные картинки сначала загружаются и кодируются; междоменные ограничения браузера могут помешать. Голый Base64, файловые пути и страницы обмена не заменяют данные изображения.
Для первого кадра aspect_ratio опускается. Сервис следует входному изображению и может обрезать или масштабировать его; для точной композиции сначала кадрируйте картинку. Обычные референсы допускают пропорции. Полной гарантии для произвольных пропорций входа нет.
4096 — байтовый лимит, не число символов. Документированные 1365 китайских символов занимали 4095 байт и проходили; 1366 занимали 4098 байт и отклонялись. Измеряйте UTF-8 для смешанного текста и сокращайте промпт.
Примеры
Ниже первый кадр и обычные референсы. Замените YOUR_IMAGE_DATA_URL полным Data URL. Для генерации по тексту удалите все референсные поля.
{
"model": "YOUR_MODEL",
"prompt": "A person turns naturally toward the camera",
"seconds": 5,
"resolution": "720p",
"input_reference": { "image_url": "YOUR_IMAGE_DATA_URL" }
}
{
"model": "YOUR_MODEL",
"prompt": "Keep the subject and visual style consistent",
"seconds": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_images": [{ "image_url": "YOUR_IMAGE_DATA_URL" }]
}
Неизвестные поля и выходное аудио
HTTP 200 не подтверждает применение seed, watermark и других недокументированных полей. Не добавляйте параметры, не открытые текущим пресетом. generate_audio управляет только выходной дорожкой, а не аудиореференсом. Неизвестные поля не обходят ограничения длительности и совместимости.
Ошибки и исправления
| Ошибка или симптом | Действие |
|---|---|
| reference-to-video duration exceeds 10s | Для референсного режима стандартной модели задайте максимум 10 секунд |
| Prompt length exceeds 4096 | Сократите число байт UTF-8 |
| Duration must be between 1 and 15 seconds | Задайте целые секунды и соблюдайте более строгий лимит режима |
| Cannot specify both image and reference_images | Оставьте только первый кадр или обычные референсы |
| grok_media_no_eligible_account | Нет доступной мощности; ограниченные повторы с задержкой, без параллельных созданий |
| imagine:content-moderated | Измените содержимое; встречались ошибки с ненулевым usage, проверяйте счёт PopGo |
| Успех без влияния картинки | Проверьте отправленные поля, загрузку и итоговые кадры; ID не доказывает использование |
Сохраните id и опрашивайте queued / in_progress / completed / failed. До повторной отправки проверьте прежнюю задачу: тайм-аут не доказывает, что она не создана. Права, баланс и доступную мощность проверяйте отдельно. Подробности: Видеозадачи.