> ## 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 API

> Call xAI Grok Imagine Video via /v1/videos.

# Grok video API

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

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

Common models (see [Model Square](https://omniall.ai/pricing)):

* `grok-imagine-video-1.5-preview`
* `grok-imagine-video`

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

```bash theme={null}
curl -X POST "https://api.omniall.ai/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "Neon alley at night, rain reflections",
    "seconds": "6",
    "aspect_ratio": "16:9",
    "resolution": "720P"
  }'
```

Full details: **API Reference → Video → Grok video**.


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