xAIvideoOperational

Grok Imagine Video 1.5 Text to Video API

Text to Video with Grok Imagine Video 1.5 by xAI. xAI's video model — native audio, up to 1080p and 15 s.

xai/grok-imagine-video/text-to-video

FromUp to −12%

$0.07/s$0.08

per second of video · 480p

Open in Studio API

Try Grok Imagine Video 1.5 Text to Video

Prompt*

0/5000

Aspect ratio

Output frame shape.

Resolution

Output resolution. Higher resolutions cost more per second.

Duration

Length of the generated clip in seconds (1–15s). You pay per second.

Estimated cost…

Create a free account with Google or email — pay only for what you generate.

Your video will appear here

Write a prompt, pick your settings and hit Run. You only pay for successful generations.

Also available: Grok Imagine Video 1.5 Reference to Video

Grok Imagine Video 1.5 Text to Video API

POST/api/v1/run/xai/grok-imagine-video/text-to-video

Submits an asynchronous job and returns 202 with a generation id. Poll GET /api/v1/generations/{id} or pass webhook_url. See job lifecycle.

Input parameters

Name	Type	Description	Affects price
`prompt`required	string	Describe the shot: subject, action, camera movement, lighting and style.	No
`aspect_ratio`	string (enum)	Output frame shape. Values: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 3:2 · 2:3 Default: 16:9	Yes
`resolution`	string (enum)	Output resolution. Higher resolutions cost more per second. Values: 480p · 720p · 1080p Default: 720p	Yes
`duration`	integer	Length of the generated clip in seconds (1–15s). You pay per second. Range: 1–15s Default: 8	Yes
`webhook_url`	string (URL)	Optional. We POST the finished generation here, signed with your webhook secret. Webhooks	No

Request

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
}'

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/xai/grok-imagine-video/text-to-video", headers=headers, json={
    "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
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/xai/grok-imagine-video/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "xai/grok-imagine-video",
  "endpoint": "xai/grok-imagine-video/text-to-video",
  "mode": "text-to-video",
  "status": "queued",
  "input": {
    "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
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "xai/grok-imagine-video",
  "endpoint": "xai/grok-imagine-video/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "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
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.ai/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Grok Imagine Video 1.5 pricing

Pay per second of video. No subscription. Failed generations are refunded automatically.

Tier	Official price	Cheaper Gen.	You save
480p audio included	~~$0.08~~/s	$0.07/s	−12%
720p audio included	~~$0.14~~/s	$0.123/s	−12%
1080p audio included	~~$0.25~~/s	$0.22/s	−12%

Official price: 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.
Each reference image adds $0.01 (before our discount).

About Grok Imagine Video 1.5 All Grok Imagine Video 1.5 endpoints