> ## 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 1.5 Video

> Generate videos with xAI Grok Imagine 1.5 Video — text-to-video, image-to-video, reference images, end frames, keyframes, and preset voices. See parameters, pricing, and API examples.

Generate videos using xAI's Grok Imagine 1.5 Video. Supports text-to-video, image-to-video from a start frame, reference-to-video with up to 14 reference images, an end frame, timestamped keyframes, and up to three preset voices for the spoken audio.

More on this model: [Grok Imagine 1.5 Video API page](https://unifically.com/models/grok-imagine-1.5-video).

> [!NOTE]
>
> [Grok Imagine 1.5 Fast Video Extend](https://docs.unifically.com/models/video/xai/grok-imagine-video-extend.md) and [Grok Imagine Upscale](https://docs.unifically.com/models/video/xai/grok-imagine-upscale.md) take task IDs from `xai/grok-imagine-1.5-fast-video` only. To continue or edit a video from this model, pass its URL to [Grok Imagine Video Extend (URL)](https://docs.unifically.com/models/video/xai/grok-imagine-video-extend.md) or [Grok Imagine Video Edit](https://docs.unifically.com/models/video/xai/grok-imagine-1.0-video-edit.md).

## Model

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

## Pricing

Current prices for this model are on the [pricing page](https://unifically.com/pricing); the playground also quotes the exact price of a request before you submit it.

## Parameters

| Parameter | Type | Required | Default | Allowed Values | Description |
| - | - | - | - | - | - |
| `prompt` | string | Conditional | `""` | — | Text prompt guiding the video. Required unless an image input is supplied |
| `aspect_ratio` | string | No | `"auto"` | `"auto"`, `"1:1"`, `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"`, `"3:2"`, `"2:3"`, `"21:9"`, `"5:2"` | Output aspect ratio. `"auto"` lets the model choose. Ignored for image-to-video (the start frame governs) |
| `duration` | int | No | `6` | `1`–`15` | Video length in seconds |
| `resolution` | string | No | `"480p"` | `"480p"`, `"720p"`, `"1080p"` | Output resolution. Reference-to-video (`image_urls`) renders up to `720p` |
| `start_image_url` | string | No | `null` | public `https://` URL | Start frame to animate. Mutually exclusive with `image_urls` |
| `image_urls` | string\[] | No | `null` | 1–14 URLs | Reference images for reference-to-video. Mutually exclusive with `start_image_url` |
| `end_image_url` | string | No | `null` | public `https://` URL | Last frame the clip must end on |
| `keyframes` | object\[] | No | `null` | up to 4 items | Images pinned to timestamps inside the clip: `[{ "image_url": "...", "timestamp": 3.0 }]`. `timestamp` is the second the image lands on (`0` = first frame) |
| `voice_ids` | string\[] | No | `null` | 1–3 preset voice IDs | Preset voices for the spoken audio (for example `"ara"`). No repeats. Requires `audio: true` |
| `audio` | boolean | No | `true` | `true`, `false` | Generate the soundtrack. `false` renders a silent clip |
| `nsfw_check` | boolean | No | `false` | `true`, `false` | Check the prompt and input images for NSFW content before generating. Off unless set to `true` |

> [!NOTE]
>
> Unknown request fields are rejected rather than ignored, so a misspelled parameter fails the request instead of silently changing what is generated.
>
> `voice_ids` are checked against the Grok voice catalog before the task starts. An unknown ID is rejected with a `422` that lists the available IDs. The catalog is available on request at [contact@unifically.com](mailto:contact@unifically.com).

## Example Requests

### 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 lighthouse on a cliff at dawn, waves crashing below",
      "aspect_ratio": "16:9",
      "duration": 8,
      "resolution": "720p"
    }
  }'
```

### 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": {
      "start_image_url": "https://example.com/start-frame.jpg",
      "prompt": "Camera slowly zooms in while clouds drift across the sky",
      "duration": 10,
      "resolution": "1080p"
    }
  }'
```

### Reference images with keyframes and voices

```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 presenter greets the audience, then turns to the skyline",
      "image_urls": [
        "https://example.com/presenter.jpg",
        "https://example.com/skyline.jpg"
      ],
      "keyframes": [
        { "image_url": "https://example.com/skyline.jpg", "timestamp": 4.0 }
      ],
      "voice_ids": ["ara"],
      "audio": true,
      "duration": 8,
      "resolution": "720p"
    }
  }'
```

## Response

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

> [!NOTE]
>
> **Volume discounts** are available for almost all models. Reach out at [contact@unifically.com](mailto:contact@unifically.com) to discuss custom pricing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.