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

# Grok video

> xAI Grok Imagine video API.

# Grok video

Call **Grok Imagine Video** through Omniall AI async endpoints:

| Action | Method | Path |
| - | - | - |
| Create | `POST` | `/v1/videos` |
| Get result | `GET` | `/v1/videos/{task_id}` |

**Host:** `https://api.omniall.ai` · Auth `Authorization: Bearer sk-...`.

## Models

See the [Model Square](https://omniall.ai/pricing). Common ids:

* `grok-imagine-video-1.5-preview`
* `grok-imagine-video`
* Other variants (e.g. `grok-video-1.5-pro`) if enabled on your account

## Scenarios

| Scenario | Key fields |
| - | - |
| Text-to-video | `prompt` + `seconds` + `aspect_ratio` + `resolution` |
| Single image-to-video | add `image` (Data URI / URL) |
| Multi-image reference | add `reference_images` (**do not combine with `image`**) |

Common ratios: `16:9`, `9:16`, `1:1`, … · Resolution: `480P` / `720P`.


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