# Grok Imagine Video 1.5 API (xAI)

> Grok Imagine Video 1.5 from xAI generates 1–15 second videos with native audio at 480p, 720p or 1080p, from text or from reference images.

Page: https://cheapergen.com/models/xai/grok-imagine-video · API reference: https://cheapergen.com/models/xai/grok-imagine-video/api

## Pricing
Official list price source: xAI API list price for grok-imagine-video-1.5 ($0.08 / s at 480p, $0.14 at 720p, $0.25 at 1080p; $0.01 per input image). Prices verified 2026-10-16.

| Tier | Official | Cheaper Gen. | Save |
|---|---|---|---|
| 480p | $0.0800/s | $0.0704/s | 12% |
| 720p | $0.1400/s | $0.0248/s | 82% |
| 1080p | $0.2500/s | $0.2200/s | 12% |

## Specs
- Resolutions: 480p · 720p · 1080p
- Duration: 1–15 s
- Aspect ratios: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 3:2 · 2:3
- Audio: Yes (included)
- Model id (xAI): grok-imagine-video-1.5

## Endpoints

### Text to Video — `POST https://cheapergen.com/api/v1/run/xai/grok-imagine-video/text-to-video`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| aspect_ratio | string (enum) (16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3) | no | Output frame shape. |
| resolution | string (enum) (480p, 720p, 1080p) | no | Output resolution. Higher resolutions cost more per second. |
| duration | integer (1–15) | no | Length of the generated clip in seconds (1–15s). You pay per second. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/xai/grok-imagine-video/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A corgi DJ in sunglasses spins records at a beach party at sunset, crowd cheering, upbeat house music",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 8
}'
```

### Reference to Video — `POST https://cheapergen.com/api/v1/run/xai/grok-imagine-video/reference-to-video`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| reference_image_urls | string[] (URLs) | yes | Up to 7 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2… |
| aspect_ratio | string (enum) (16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3) | no | Output frame shape. |
| resolution | string (enum) (480p, 720p, 1080p) | no | Output resolution. Higher resolutions cost more per second. |
| duration | integer (1–15) | no | Length of the generated clip in seconds (1–15s). You pay per second. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/xai/grok-imagine-video/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "@Image1 rides a bicycle through a field of sunflowers, wind in her hair, cheerful whistling",
  "reference_image_urls": [
    "https://cdn.cheapergen.ai/samples/reference-1.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 8
}'
```

## Getting the result
Jobs are async. Poll `GET https://cheapergen.com/api/v1/generations/{id}` until status is succeeded/failed/canceled, or pass `webhook_url`. Failed generations are refunded automatically.

## FAQ
**How is Grok Imagine Video priced?**
Per second of output at the chosen resolution, with audio included; each reference image adds a cent before our discount. Failed generations are never charged.

**Is this the official Grok Imagine?**
Yes. Requests run on xAI's grok-imagine-video-1.5 through an official xAI API channel, at a lower price than xAI's list price.

**Can I use the output commercially?**
Yes, subject to xAI's terms and acceptable use policy and our Terms of Service.

Grok Imagine Video 1.5 is developed by xAI. Cheaper Gen. provides API access and does not own the model.