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

# Grok Imagine Video 1.5

> Generate videos with native synchronized audio from a prompt, an opening image, or up to seven reference images.

Generate videos with native synchronized audio from a prompt, an opening image, or up to seven reference images.

| | |
| - | - |
| Model id | `grok-imagine-video-1.5-fal` |
| Media | video |
| Submit to | `POST /v1/videos` |
| Price | varies by tier and settings; `GET /v1/models/grok-imagine-video-1.5-fal/estimate` quotes it |
| Typical time | about 30.0 s |

## Text → Video

Generate a video with synchronized audio from a prompt.

Select it with `"mode": "text_to_video"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `duration_seconds`\
**Optional:** `aspect_ratio`

Resolution tiers: `480p`, `720p`, `1080p` (send as `tier`).

```json theme={null}
{
  "model": "grok-imagine-video-1.5-fal",
  "prompt": "Wide tracking shot past buffet tables, warm night wedding light, shallow depth, photoreal, no faces sharp in frame. No text.",
  "mode": "text_to_video",
  "aspect_ratio": "16:9",
  "duration_seconds": 6,
  "tier": "720p"
}
```

| Field | Allowed | Default |
| - | - | - |
| `aspect_ratio` | `16:9`, `4:3`, `3:2`, `1:1`, `2:3`, `3:4`, `9:16` | `"16:9"` |
| `duration_seconds` | 1.0 – 15.0 seconds | `6` |

## Image → Video

Animate an opening image with synchronized audio. Output framing follows the image.

Select it with `"mode": "image_to_video"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `first_frame`, `duration_seconds`\
**Optional:** none

Resolution tiers: `480p`, `720p`, `1080p` (send as `tier`).

```json theme={null}
{
  "model": "grok-imagine-video-1.5-fal",
  "prompt": "Wide tracking shot past buffet tables, warm night wedding light, shallow depth, photoreal, no faces sharp in frame. No text.",
  "mode": "image_to_video",
  "duration_seconds": 6,
  "first_frame": "asset_…",
  "tier": "720p"
}
```

| Field | Allowed | Default |
| - | - | - |
| `duration_seconds` | 1.0 – 15.0 seconds | `6` |
| `first_frame` | asset id (up to 1) | |

## Reference → Video

Guide the video with one to seven reference images. This mode supports 480p and 720p.

Select it with `"mode": "reference_to_video"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `reference_images`, `duration_seconds`\
**Optional:** `aspect_ratio`

Resolution tiers: `480p`, `720p` (send as `tier`).

```json theme={null}
{
  "model": "grok-imagine-video-1.5-fal",
  "prompt": "Wide tracking shot past buffet tables, warm night wedding light, shallow depth, photoreal, no faces sharp in frame. No text.",
  "mode": "reference_to_video",
  "aspect_ratio": "16:9",
  "duration_seconds": 8,
  "reference_images": [
    "asset_…"
  ],
  "tier": "720p"
}
```

| Field | Allowed | Default |
| - | - | - |
| `aspect_ratio` | `16:9`, `4:3`, `3:2`, `1:1`, `2:3`, `3:4`, `9:16` | `"16:9"` |
| `duration_seconds` | 1.0 – 15.0 seconds | `8` |
| `reference_images` | asset ids (up to 7) | |

Reference inputs take asset ids from [`POST /v1/uploads`](/uploads) or an earlier output's `asset_id`.
Prices and allowed values come from the live catalog; `GET /v1/models/grok-imagine-video-1.5-fal` is always current.


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