# Grok Imagine Video 1.5 — /videos/generations

Grok Imagine Video 1.5 (async): duration is any integer 4-15 seconds, resolution 480P / 720P, size 16:9 / 9:16 / 1:1 / 4:3 / 3:4; include image for image-to-video (up to 7 references; 2 or more caps the clip at 10 seconds). Returns a job id (HTTP 202); poll GET /v1/videos/jobs/{id} until status=succeeded, result in data[0].url. Billed PER CLIP: 480P $0.30 / 720P $0.40 (default 720P); within a tier the shortest and the longest clip cost the same. Fully refunded on failure.

**Эндпоинт:** `POST https://nezhagate.com/v1/videos/generations`

## Аутентификация
```
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Тело запроса
| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| `model` | string | Да | Model ID, here grok-imagine-video-1.5. |
| `prompt` | string | Да | Text prompt describing the video, camera and motion. Max 5000 bytes (UTF-8; a Chinese character counts as 3). |
| `duration` | integer | Нет | Length in seconds, any integer 4-15 (default 15, i.e. the longest -- billed PER CLIP, so length does not change the price); alias seconds. With 2 or more reference images the cap drops to 10 seconds. |
| `resolution` | string | Нет | Resolution: 480P $0.30 / 720P $0.40 (default 720P). Price follows the resolution, not the length. |
| `size` | string | Нет | Aspect ratio: 16:9 / 9:16 / 1:1 / 4:3 / 3:4 (default 16:9); alias aspect_ratio. 21:9 is not available on this model. |
| `image` | string | Нет | Изображение в видео: укажите референсное изображение (публичный URL, data: URI или base64); не указывайте для режима текст в видео. |
| `images` | array | Нет | Multiple reference images, up to 7. Exceeding the cap is rejected, never truncated. Alias: reference_images. |

## Пример запроса
```bash
# 1) submit -> 202 {"id":"img_...","status":"queued"}
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "grok-imagine-video-1.5", "prompt": "a paper crane unfolding over a misty lake", "duration": 15, "resolution": "720P", "size": "16:9"}'
# image-to-video: also pass  "image": "https://example.com/ref.png"
# 2) poll every ~5s until status=succeeded, then read data[0].url
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'
```

## Ответ
```json
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "queued",
  "model": "grok-imagine-video-1.5"
}
```