> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifically.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Imagine Video 1.5

> Generate videos with xAI Grok Imagine 1.5 — text-to-video and image-to-video

Generate high-quality AI videos using xAI's Grok Imagine 1.5 model. This is the successor to [Grok Imagine Video](/models/video/xai/grok-imagine-video) and supports **text-to-video** and **image-to-video** with up to **7 reference images** and durations up to **30 seconds**.

## Model

```
xai/grok-imagine-1.5-video
```

## Modes

| Mode                     | How to activate                 | Description                                                                                                                        |
| ------------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Text-to-video (T2V)**  | Omit `start_frame_image_url`    | Generate video from a text prompt. Optionally pass up to 7 reference images via `image_urls`                                       |
| **Image-to-video (I2V)** | Provide `start_frame_image_url` | Animate a starting frame into video. Optionally pass additional reference images via `image_urls` (max 7 total across both fields) |

## Parameters

| Parameter               | Type      | Required | Default    | Allowed Values                                                    | Description                                                |
| ----------------------- | --------- | -------- | ---------- | ----------------------------------------------------------------- | ---------------------------------------------------------- |
| `prompt`                | string    | Yes      | —          | 2–3000 chars                                                      | Video generation prompt                                    |
| `start_frame_image_url` | string    | No       | `null`     | —                                                                 | Start frame image URL for I2V mode                         |
| `image_urls`            | string\[] | No       | `null`     | 1–7 URLs                                                          | Reference image URLs for style, subject, or scene guidance |
| `aspect_ratio`          | string    | No       | `"auto"`   | `"auto"`, `"9:16"`, `"3:4"`, `"1:1"`, `"4:3"`, `"16:9"`, `"21:9"` | Output aspect ratio                                        |
| `duration`              | int       | No       | —          | `1`–`30`                                                          | Video length in seconds                                    |
| `resolution`            | string    | No       | —          | `"480p"`, `"720p"`                                                | Output resolution                                          |
| `video_preset`          | string    | No       | `"custom"` | `"custom"`, `"spicy"`, `"fun"`, `"normal"`                        | Generation style preset                                    |

**Video presets:**

| Preset   | Style                |
| -------- | -------------------- |
| `custom` | Default generation   |
| `spicy`  | Extremely spicy/nsfw |
| `fun`    | Extremely crazy/fun  |
| `normal` | Normal style         |

## Example Request

### Text to Video

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "xai/grok-imagine-1.5-video",
    "input": {
      "prompt": "A futuristic cityscape at sunset with flying cars",
      "duration": 10,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "video_preset": "custom"
    }
  }'
```

### Image to Video

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "xai/grok-imagine-1.5-video",
    "input": {
      "prompt": "Camera slowly zooms in while clouds drift across the sky",
      "start_frame_image_url": "https://example.com/start-frame.jpg",
      "duration": 6,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }'
```

### Text to Video with Reference Images

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "xai/grok-imagine-1.5-video",
    "input": {
      "prompt": "The character walks through a neon-lit alley at night",
      "image_urls": [
        "https://example.com/character-ref.jpg",
        "https://example.com/style-ref.jpg"
      ],
      "duration": 15,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }'
```

## Response

```json theme={null}
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}
```