Back to Text to video

Grok Imagine Video 1.5 Text-to-Video

xAI

Generate video from a text prompt with duration, resolution and aspect-ratio controls.

Current price
$0.1960/video second
Availability
Ready to run
Last accepted verification

What this API does

Create a 480p, 720p or 1080p Grok Imagine Video 1.5 clip from text with explicit duration, resolution and aspect ratio. Scrollport preserves the generated MP4 as a private artifact and charges only the selected resolution-seconds.

Agents select this operation with tool ID xai.grok-imagine-video-1-5-text-to-video, then inspect its current executable contract before a run.

Public input and output shape

Input

aspect_ratiostring · optional

Value supplied for aspect ratio.

enum: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16

durationinteger · optional

Value supplied for duration.

minimum: 1 · maximum: 15

promptstring · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 4096

resolutionstring · optional

Value supplied for resolution.

enum: 480p, 720p, 1080p

Output

notestring

Returned note value.

videoobject

Returned video value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "xai.grok-imagine-video-1-5-text-to-video",
  "input": {
    "prompt": "a white kitten follows a butterfly through a sunlit garden as the camera tracks gently beside it",
    "duration": 3,
    "resolution": "480p",
    "aspect_ratio": "16:9"
  }
}

Output

{
  "note": "video returned as an artifact",
  "video": {
    "audio": true,
    "resolution": "480p",
    "content_type": "video/mp4",
    "duration_seconds": 3
  }
}
Teaching errors and limitations
  • invalid_input: duration must be 1–15 seconds and resolution must be 480p, 720p or 1080pexample: {"prompt":"a white kitten follows a butterfly through a sunlit garden as the camera tracks gently beside it","duration":3,"resolution":"480p","aspect_ratio":"16:9"}
Updated
18 August 2026

Use Grok Imagine Video 1.5 Text-to-Video with Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.