Grok Imagine Video 1.5 Lite API documentation

Name: Grok Imagine Video 1.5 Lite API
Brand: xAI
SKU: xai/grok-imagine-video-1.5-lite
Availability: InStock

Everything you need to call Grok Imagine Video 1.5 Lite from your code. Base URL https://cheapergen.com/api/v1. Try it first in the playground.

Using a coding agent?

Paste this into Claude Code, Cursor, Codex or any coding agent. It adds the API to your project, keeps the key in CHEAPERGEN_API_KEY and tests with a free quote before anything is spent.

Add Grok Imagine Video 1.5 Lite (CheaperGen endpoint xai/grok-imagine-video-1.5-lite/text-to-video) to this project by following https://cheapergen.com/agents/integrate.md

What your agent reads

Authentication

Create a key in Dashboard → API keys and send it as a bearer token. Keep keys server-side.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

Grok Imagine Video 1.5 Lite Text to Video API

POST/api/v1/run/xai/grok-imagine-video-1.5-lite/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

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-1.5-lite/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon reflections rippling on the water, soft rain ambience",
    "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);

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-1.5-lite/text-to-video", headers=headers, json={
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon reflections rippling on the water, soft rain ambience",
    "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"])

curl -X POST https://cheapergen.com/api/v1/run/xai/grok-imagine-video-1.5-lite/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon reflections rippling on the water, soft rain ambience",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 8
}'

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "xai/grok-imagine-video-1.5-lite",
  "endpoint": "xai/grok-imagine-video-1.5-lite/text-to-video",
  "mode": "text-to-video",
  "status": "queued",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon reflections rippling on the water, soft rain ambience",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 8
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "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-1.5-lite",
  "endpoint": "xai/grok-imagine-video-1.5-lite/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon reflections rippling on the water, soft rain ambience",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 8
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4"
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "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 Lite Image to Video API

POST/api/v1/run/xai/grok-imagine-video-1.5-lite/image-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
`image_url`required	string (URL)	Image used as the opening frame; the clip keeps its shape. JPG/PNG/WebP, URL or upload.	No
`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

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-1.5-lite/image-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "She turns toward the camera and smiles as the wind moves through her hair, soft café chatter",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "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);

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-1.5-lite/image-to-video", headers=headers, json={
    "prompt": "She turns toward the camera and smiles as the wind moves through her hair, soft café chatter",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "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"])

curl -X POST https://cheapergen.com/api/v1/run/xai/grok-imagine-video-1.5-lite/image-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "She turns toward the camera and smiles as the wind moves through her hair, soft café chatter",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "resolution": "720p",
  "duration": 8
}'

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "xai/grok-imagine-video-1.5-lite",
  "endpoint": "xai/grok-imagine-video-1.5-lite/image-to-video",
  "mode": "image-to-video",
  "status": "queued",
  "input": {
    "prompt": "She turns toward the camera and smiles as the wind moves through her hair, soft café chatter",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 8
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "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-1.5-lite",
  "endpoint": "xai/grok-imagine-video-1.5-lite/image-to-video",
  "mode": "image-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "She turns toward the camera and smiles as the wind moves through her hair, soft café chatter",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 8
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4"
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "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"
}

Get the result

Generations are asynchronous. Poll until status is succeeded, failed or canceled — or pass webhook_url when you submit. Failed generations are refunded automatically.

curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

200 — succeeded

{
  "status": "succeeded",
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4"
    }
  }
}

More: job lifecycle · webhooks · errors

Grok Imagine Video 1.5 Lite pricing

Pay per second of video as you go, with no subscription required. Failed generations are refunded automatically.

Tier	Official price	CheaperGen	You save
480p audio included	~~$0.02~~/s	$0.0146/s With a monthly plan: Pro $0.0139Max $0.0133	−27%
720p audio included	~~$0.03~~/s	$0.0219/s With a monthly plan: Pro $0.0209Max $0.0199	−27%
1080p audio included	~~$0.14~~/s	$0.1021/s With a monthly plan: Pro $0.0973Max $0.0925	−27%

Monthly plans lower prices on most models (shown under each price); you can still pay as you go. Pro $499/month · Max $4,999/month.

Official price: xAI API list price for grok-imagine-video-1.5-lite ($0.02 / s at 480p, $0.03 at 720p, $0.14 at 1080p; $0.01 per input image). Prices verified October 18, 2026.
Image to video adds $0.01 for the first frame (before our discount).