Grok Imagine Video 1.5

Model id grok-imagine-video-1.5 · xAI · video · 3 modes: text-to-video, image-to-video, reference-to-video.

This page reflects the current catalog. Inputs, allowed values, limits and prices can change as the model evolves; the field names and their meaning do not. For the exact schema at any time, your agent calls get_model with the mode.

Text To Video

Mode text-to-video. Text to video.

Input

Field	Type	Required	Allowed	Description
`prompt`	string	Yes		What the video should show: subject, action, camera and style.
`duration`	integer	Yes	1 to 15	Video duration in seconds, 1-15.
`aspect_ratio`	string		`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	Aspect ratio.
`resolution`	string		`480p`, `720p`	Video resolution: 480p (default) or 720p.

Pricing

3.87 credits/s (480p), 6.77 credits/s (720p), + 0.48 credits per input image (frame or reference). Fixed price: charged as estimated. For the exact price of a request, use estimate_generation.

Example

The arguments of generate_media:

{
  "model": "grok-imagine-video-1.5",
  "mode": "text-to-video",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera",
    "duration": 1,
    "aspect_ratio": "1:1",
    "resolution": "480p"
  }
}

Image To Video

Mode image-to-video. Animate a start image, optionally to an end image.

Input

Field	Type	Required	Allowed	Description
`prompt`	string	Yes		What the video should show: subject, action, camera and style.
`duration`	integer	Yes	1 to 15	Video duration in seconds, 1-15.
`aspect_ratio`	string		`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	Aspect ratio.
`resolution`	string		`480p`, `720p`	Video resolution: 480p (default) or 720p.
`first_frame`	File			The image to animate, as the first frame.
`last_frame`	File			Optional image to end on: the video goes from one to the other.

Pricing

3.87 credits/s (480p), 6.77 credits/s (720p), + 0.48 credits per input image (frame or reference). Fixed price: charged as estimated. For the exact price of a request, use estimate_generation.

Example

The arguments of generate_media:

{
  "model": "grok-imagine-video-1.5",
  "mode": "image-to-video",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera",
    "duration": 1,
    "aspect_ratio": "1:1",
    "resolution": "480p"
  }
}

Reference To Video

Mode reference-to-video. A video guided by up to 7 reference images.

Input

Field	Type	Required	Allowed	Description
`prompt`	string	Yes		What the video should show, naming the references <IMAGE_1>, <IMAGE_2>, etc.
`duration`	integer	Yes	1 to 10	Video duration in seconds, 1-10.
`aspect_ratio`	string		`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	Aspect ratio.
`resolution`	string		`480p`, `720p`	Video resolution: 480p (default) or 720p.
`references`	File list	Yes	1 to 7 items	References the output must follow. The kind of each one (image, video, audio) is read from the file; per-kind limits are in the mode’s `capabilities.references`.

References: up to 7: 7 images. Assets, URLs and elements are accepted.

Pricing

3.87 credits/s (480p), 6.77 credits/s (720p), + 0.48 credits per input image (frame or reference). Fixed price: charged as estimated. For the exact price of a request, use estimate_generation.

Example

The arguments of generate_media:

{
  "model": "grok-imagine-video-1.5",
  "mode": "reference-to-video",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera, keeping the look of the reference",
    "duration": 1,
    "aspect_ratio": "1:1",
    "resolution": "480p",
    "references": [
      "asset_91a3c7e5b2d84f6a8e0c1b9d7f3a5e24"
    ]
  }
}

Models

Video

Image

Audio

Grok Imagine Video 1.5

Text To Video

Input

Pricing

Example

Image To Video

Input

Pricing

Example

Reference To Video

Input

Pricing

Example

​Text To Video

​Input

​Pricing

​Example

​Image To Video

​Input

​Pricing

​Example

​Reference To Video

​Input

​Pricing

​Example

Text To Video

Input

Pricing

Example

Image To Video

Input

Pricing

Example

Reference To Video

Input

Pricing

Example