Video models
Grok Imagine Video 1.5
On this page
Grok Imagine Video 1.5 — high-quality AI video generation.
| modelId | grok-imagine-video-1-5-preview |
| Modality | video |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Default | grok-imagine-video-1-5-preview | POST /api/v1/generate | image_urls |
| Poll task | — | GET /api/v1/task/{id}?model=grok-imagine-video-1-5-preview | — |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | No | Prompt for video generation Max 4096 characters. (example: Create an 8-second cinematic product film. Slow push-in on a matte-black wireless speaker turning a quarter revolution on a brushed-steel plinth, dust motes… — full value in the request example) |
| image_urls | string[] | Yes | Upload an image file to use as input for the API (image URL) |
| aspect_ratio | string | No | Aspect ratio for video generation.If not uploaded, follow the image size. (options: auto | 1:1 | 16:9 | 9:16 | 3:2 | 2:3) (default: auto) |
| resolution | string | No | Resolution for video generation. (options: 480p | 720p) (default: 480p) |
| duration | number | No | Video duration in seconds. Range: [1, 15]. Default: 8. (range 1-15) (default: 8) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
Example request
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"grok-imagine-video-1-5-preview","input":{"prompt":"Create an 8-second cinematic product film. Slow push-in on a matte-black wireless speaker turning a quarter revolution on a brushed-steel plinth, dust motes drifting through a single hard key light. Deep shadows, one warm rim highlight tracing the top edge, shallow depth of field settling on the speaker grille. Steady tripod move, no cuts, no camera shake. Ultra-realistic commercial cinematography. No logos, no brand references, no watermark, no people.","image_urls":["https://you.bot/examples/grok-imagine-text-to-image.jpg"],"aspect_ratio":"auto","resolution":"480p","duration":8,"nsfw_checker":true}}'