Grok Imagine Video
model-grok-imagine-videoPOST/v1/generationsОриентирот 151,74 кредитовПопробовать
#Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.
Параметры
#promptstringобязательныйЧто нужно создать? — Опишите сюжет, композицию, стиль и важные детали.
- По умолчанию
- нет
- Ограничения
- до 20000 символов
start_image_urlfile · inputAssetsнеобязательныйСтартовый кадр — Необязательно: загрузите изображение, чтобы анимировать его.
- По умолчанию
- нет
- Ограничения
- форматы: image/* · сценарии: scenario-0
durationnumber (enum)необязательныйДлительность
- По умолчанию
6
Допустимые значения
66 сек.1010 сек.
aspect_ratiostring (enum)необязательныйФормат кадра
- По умолчанию
"16:9"- Ограничения
- сценарии: scenario-1
Допустимые значения
1:11:1 · квадрат2:32:3 · вертикальный3:23:2 · горизонтальный16:916:9 · горизонтальный9:169:16 · вертикальный
number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.
Сценарии
#scenario-0передан файл start_image_url
Активные поля: prompt, start_image_url, duration
{
"model": "model-grok-imagine-video",
"values": {
"prompt": "Describe the desired result",
"duration": 6
},
"inputAssets": [
{
"fieldName": "start_image_url",
"assetId": "REPLACE_WITH_READY_ASSET_ID",
"position": 0
}
]
}scenario-1по умолчанию
Активные поля: prompt, duration, aspect_ratio
{
"model": "model-grok-imagine-video",
"values": {
"prompt": "Describe the desired result",
"duration": 6,
"aspect_ratio": "16:9"
},
"inputAssets": []
}Цена и результат
#Ориентир при стандартных настройках — 151,74 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через estimate. Запуск возвращает HTTP 202, дальше опрашивайте GET /v1/generations/:id раз в 3–5 секунд до completed или failed.
Готовые файлы — в assets[] (url, downloadUrl, mediaAssetId), текст — в textOutput, 3D — в viewerUrl/modelUrl, а выбор форматов скачивания (GLB, FBX, OBJ) — в modelFormats[]. Ответ также содержит prompt, reuseValues, projectId, billingMode и usageUsdMicros. Подробнее — в разделах Запуск и статус и Ошибки и лимиты.
Машиночитаемая схема: GET /v1/generation-models/model-grok-imagine-video. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.