Grok Imagine

Grok Imagine 1.5

Создание и редактирование видео

POSThttps://api.aisetup.ru/v1/video/generations

Header:Authorization: Bearer YOUR_KEY

Параметры

Параметр	Тип	Описание
model	string	"grok-imagine-1-5"
webhook_url*	string	URL для webhook (необязателен), поллинг: GET /v1/requests/{id}
input	object	Параметры запроса.
↳ prompt	string	Текстовое описание движения/сцены. Обязателен. Максимум 4096 символов.
↳ image_url	string	URL исходного изображения (ровно 1). ОБЯЗАТЕЛЕН: Grok Imagine работает только как image-to-video, text-to-video не поддерживается. Форматы: JPG/PNG/WEBP.
↳ resolution*	string	Разрешение: "480" \| "720". По умолчанию "480".
↳ aspect_ratio*	string	Соотношение сторон: "1:1" \| "16:9" \| "9:16" \| "3:2" \| "2:3" \| "auto". По умолчанию "auto".
↳ duration*	number	Длительность в секундах, целое 1–15. По умолчанию 8. Влияет на стоимость (тариф за секунду).

* — опциональные поля.

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

# image-to-video (image_url обязателен)
curl -s "https://api.aisetup.ru/v1/video/generations" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-1-5","webhook_url":"https://your.site/hook","input":{"prompt":"Плавный наезд камеры, кинематографичный свет","image_url":"https://example.com/image.jpg","resolution":"480","aspect_ratio":"auto","duration":8}}'

Ответы API

Структура ответа

Поле	Тип	Описание
id	string	ID запроса для polling / webhook.
status	string	running — генерация запущена.

Пример тела ответа (JSON)

{
  "id": "REQUEST_ID",
  "status": "running"
}

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

Webhook или polling, подробнее в карточке «Проверка статуса видео-запроса»

При успехе result.type = "video_generation", массив result.videos:

{
  "id": "REQUEST_ID",
  "status": "success",
  "result": {
    "type": "video_generation",
    "videos": [
      "https://cdn.aisetup.ru/.../result.mp4"
    ]
  }
}