Grok Video 1.5

In this page's examples, {BASE_URL} is https://api.uniall.ai.

Updated: 2026-08-03

Use the public model grok-video-1.5 for text-to-video, single-image animation, and multi-image reference generation. Submit a task through the UniAll async video API, then poll the task until it completes or fails.

1. Capability Scope

Mode	Image Input	Prompt	Maximum Resolution
Text-to-video	No image field	Required	`1080p`
Single-image-to-video	One `image` or `image_url`	Optional	`1080p`
Reference-to-video	1 to 7 `reference_images` or `reference_image_urls`	Required	`720p`

The model also supports:

durations from 1 to 15 seconds, defaulting to 8 seconds;
480p, 720p, and 1080p output, defaulting to 480p;
auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, and 2:3 aspect ratios;
HTTP(S) image URLs and complete image Data URLs.

This public model does not support reference audio, source-video editing, or video extension. Use the existing Grok Imagine video models for edit and extend workflows.

2. When To Use It

Use grok-video-1.5 when you need to:

create a video directly from a text prompt;
animate one source image, with or without an additional prompt;
keep a character, product, or visual style consistent across 1 to 7 reference images;
request up to 1080p for text-to-video or single-image generation.

Do not use this model for first-and-last-frame generation, reference audio, video editing, or video extension.

3. Endpoint And Authentication

Use the primary endpoints for new integrations:

Purpose	Method	Path
Create a video task	`POST`	`/v1/videos`
Query a video task	`GET`	`/v1/videos/{task_id}`

The compatible /v1/videos/generations create and query paths remain available.

Every request requires a Bearer token:

Authorization: Bearer sk-***

Task creation also requires:

Content-Type: application/json

4. Request Body Parameters

Parameter	Type	Required	Description
`model`	string	Yes	Must be `grok-video-1.5`.
`prompt`	string	Conditional	Required for text and reference generation; optional for single-image generation.
`duration`	integer or integer string	No	`1` to `15`. Defaults to `8`.
`seconds`	integer or integer string	No	Compatible alias for `duration`. If both are present, their values must match.
`resolution`	string	No	`480p`, `720p`, or `1080p`. Defaults to `480p`. Reference generation supports up to `720p`.
`size`	string	No	Compatible alias for `resolution`. If both are present, their values must match.
`aspect_ratio`	string	No	`auto`, `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, or `2:3`.
`image`	object	No	One structured image in the form `{"url":"..."}`.
`image_url`	string	No	Compatible single-image field.
`reference_images`	object[]	No	1 to 7 structured images in the form `[{"url":"..."}]`.
`reference_image_urls`	string[]	No	Compatible array containing 1 to 7 image URLs or Data URLs.

Prefer duration over seconds, resolution over size, and the structured image or reference_images fields in new integrations.

Image Field Selection

The four image fields are mutually exclusive. Choose exactly one field for an image-based request:

Input Shape	Use
One structured image	`image: {"url":"..."}`
One compatible string field	`image_url: "..."`
Multiple structured references	`reference_images: [{"url":"..."}]`
Multiple compatible string references	`reference_image_urls: ["..."]`

Do not combine single-image fields with reference-image fields in the same request.

Supported Image Values

Every image value must be either:

a server-accessible http:// or https:// URL; or
a complete image Data URL such as data:image/png;base64,....

Bare Base64 strings, local file paths, browser-session URLs, images, image_urls, and every form of file_id are rejected.

5. Request Examples

5.1 Text-To-Video

This request uses 1080p and the default 8-second duration:

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "prompt": "A quiet mountain lake at sunrise, gentle camera movement, realistic reflections.",
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

5.2 Single Image From An HTTP URL

The prompt is optional for single-image generation:

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "image": {
      "url": "https://example.com/product.jpg"
    },
    "duration": 6,
    "resolution": "720p"
  }'

5.3 Single Image From A Data URL

Pass the complete Data URL, including its media type and Base64 prefix:

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "prompt": "Subtle camera push-in and natural fabric movement.",
    "image_url": "data:image/png;base64,iVBORw0KGgo...",
    "duration": 5,
    "size": "480p",
    "aspect_ratio": "9:16"
  }'

5.4 Multiple Reference Images

Reference generation accepts 1 to 7 images and is limited to 480p or 720p:

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "prompt": "Keep the character identity and clothing consistent while the character turns toward the camera.",
    "reference_images": [
      {"url": "https://example.com/character-front.jpg"},
      {"url": "https://example.com/character-side.jpg"}
    ],
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "9:16"
  }'

6. Response Examples

Task Created

Save id or the compatible task_id value for polling.

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "grok-video-1.5",
  "status": "queued",
  "raw_status": "PENDING",
  "progress": 0,
  "created_at": 1785715200,
  "video_url": null
}

7. Task Status And Result

After creation, save id or task_id, then poll GET /v1/videos/{task_id} until the task reaches completed or failed. See Video Generation Overview for the shared polling interval, status fields, error contract, result URL, and authenticated download flow.

8. Aspect Ratio Behavior

If text-to-video omits aspect_ratio, the effective default is normally 16:9.
If single-image generation omits it, output normally follows the source image ratio.
auto is accepted as a compatibility value.
For predictable framing, prepare source and reference images in the desired output orientation.

9. Billing Notes

This page does not define an exact user price. The normalized duration, resolution, and number of input images affect billing:

omitted duration is billed using the 8-second default;
text-to-video has no input-image charge dimension;
single-image generation counts one input image;
reference generation counts every supplied reference image;
higher resolution generally costs more.

Check current pricing in the UniAll console and review account usage after task creation. Wait for the original task's terminal state before retrying it.

10. Common Errors

Missing `prompt`

prompt is required for text-to-video and reference-to-video. It may be omitted only for a single-image request.

Conflicting Image Fields

Do not combine image, image_url, reference_images, or reference_image_urls. Choose one field only.

Invalid Image Encoding

Use an HTTP(S) URL or a complete Data URL. A bare Base64 string such as iVBORw0KGgo... is invalid.

Reference Generation At `1080p`

Reference generation supports at most 720p. Use 480p or 720p, or switch to text or single-image generation for 1080p.

Too Many Reference Images

reference_images and reference_image_urls accept 1 to 7 images. An empty array or more than 7 images is invalid.

Unsupported Fields

Do not pass file_id, reference_audios, reference_audio_urls, voice_id, output, storage_options, or user. Do not place them inside extra_body.

Unsupported Video Operations

Reference audio, first-and-last-frame generation, video editing, and video extension are not part of grok-video-1.5.

11. Migration From The Previous Contract

Item	Previous Contract	Current Contract
Generation modes	Single-image only	Text, single-image, and 1-to-7-image reference generation
Image fields	`image_url` only	Structured `image` / `reference_images` plus compatible URL fields
Image values	HTTP(S) URL only	HTTP(S) URL or complete image Data URL
Single-image prompt	Required	Optional
Duration	Required integer `duration`	`duration` or `seconds`, `1..15`, default `8`
Resolution	`480p` or `720p`	Also `1080p` for text and single-image generation
Aspect ratio	Six values plus `auto`	Adds `4:3` and `3:4`

Do not migrate to provider-native model names or file IDs. Keep using the stable public model grok-video-1.5 and the UniAll task endpoints.

1. Capability Scope​

2. When To Use It​

3. Endpoint And Authentication​

4. Request Body Parameters​

Image Field Selection​

Supported Image Values​

5. Request Examples​

5.1 Text-To-Video​

5.2 Single Image From An HTTP URL​

5.3 Single Image From A Data URL​

5.4 Multiple Reference Images​

6. Response Examples​

Task Created​

7. Task Status And Result​

8. Aspect Ratio Behavior​

9. Billing Notes​

10. Common Errors​

Missing prompt​

Conflicting Image Fields​

Invalid Image Encoding​

Reference Generation At 1080p​

Too Many Reference Images​

Unsupported Fields​

Unsupported Video Operations​

11. Migration From The Previous Contract​

12. Related Pages​