Grok Imagine 1.5 Video

Generate videos using xAI’s Grok Imagine 1.5 Video. Supports text-to-video, image-to-video from a start frame, reference-to-video with up to 14 reference images, an end frame, timestamped keyframes, and up to three preset voices for the spoken audio. More on this model: Grok Imagine 1.5 Video API page.

Grok Imagine 1.5 Fast Video Extend and Grok Imagine Upscale take task IDs from xai/grok-imagine-1.5-fast-video only. To continue or edit a video from this model, pass its URL to Grok Imagine Video Extend (URL) or Grok Imagine Video Edit.

Model

xai/grok-imagine-1.5-video

Pricing

Current prices for this model are on the pricing page; the playground also quotes the exact price of a request before you submit it.

Parameters

Parameter	Type	Required	Default	Allowed Values	Description
`prompt`	string	Conditional	`""`	—	Text prompt guiding the video. Required unless an image input is supplied
`aspect_ratio`	string	No	`"auto"`	`"auto"`, `"1:1"`, `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"`, `"3:2"`, `"2:3"`, `"21:9"`, `"5:2"`	Output aspect ratio. `"auto"` lets the model choose. Ignored for image-to-video (the start frame governs)
`duration`	int	No	`6`	`1`–`15`	Video length in seconds
`resolution`	string	No	`"480p"`	`"480p"`, `"720p"`, `"1080p"`	Output resolution. Reference-to-video (`image_urls`) renders up to `720p`
`start_image_url`	string	No	`null`	public `https://` URL	Start frame to animate. Mutually exclusive with `image_urls`
`image_urls`	string[]	No	`null`	1–14 URLs	Reference images for reference-to-video. Mutually exclusive with `start_image_url`
`end_image_url`	string	No	`null`	public `https://` URL	Last frame the clip must end on
`keyframes`	object[]	No	`null`	up to 4 items	Images pinned to timestamps inside the clip: `[{ "image_url": "...", "timestamp": 3.0 }]`. `timestamp` is the second the image lands on (`0` = first frame)
`voice_ids`	string[]	No	`null`	1–3 preset voice IDs	Preset voices for the spoken audio (for example `"ara"`). No repeats. Requires `audio: true`
`audio`	boolean	No	`true`	`true`, `false`	Generate the soundtrack. `false` renders a silent clip
`nsfw_check`	boolean	No	`false`	`true`, `false`	Check the prompt and input images for NSFW content before generating. Off unless set to `true`

Unknown request fields are rejected rather than ignored, so a misspelled parameter fails the request instead of silently changing what is generated.voice_ids are checked against the Grok voice catalog before the task starts. An unknown ID is rejected with a 422 that lists the available IDs. The catalog is available on request at contact@unifically.com.

Example Requests

Text to video

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "xai/grok-imagine-1.5-video",
    "input": {
      "prompt": "A lighthouse on a cliff at dawn, waves crashing below",
      "aspect_ratio": "16:9",
      "duration": 8,
      "resolution": "720p"
    }
  }'

Image to video

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "xai/grok-imagine-1.5-video",
    "input": {
      "start_image_url": "https://example.com/start-frame.jpg",
      "prompt": "Camera slowly zooms in while clouds drift across the sky",
      "duration": 10,
      "resolution": "1080p"
    }
  }'

Reference images with keyframes and voices

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "xai/grok-imagine-1.5-video",
    "input": {
      "prompt": "The presenter greets the audience, then turns to the skyline",
      "image_urls": [
        "https://example.com/presenter.jpg",
        "https://example.com/skyline.jpg"
      ],
      "keyframes": [
        { "image_url": "https://example.com/skyline.jpg", "timestamp": 4.0 }
      ],
      "voice_ids": ["ara"],
      "audio": true,
      "duration": 8,
      "resolution": "720p"
    }
  }'

Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}

Volume discounts are available for almost all models. Reach out at contact@unifically.com to discuss custom pricing.