API docs / Video models

Grok Imagine Video 1.5 (Reference to video) API

Combine up to seven reference images, tagged <IMAGE_0>, <IMAGE_1>…

Model id
xai/grok-imagine-video/v1.5/reference-to-video
Provider
xAI
Output
Video
Price
From 227 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "xai/grok-imagine-video/v1.5/reference-to-video". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "xai/grok-imagine-video/v1.5/reference-to-video",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light",
    "reference_images": [
      "https://example.com/input.png"
    ]
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

Write the shot and tag each reference in upload order as <IMAGE_0>, <IMAGE_1> and so on.

Up to 4096 characters

reference_imagesrequiredarray of URLs

One to seven images of characters, products or places. The first upload is <IMAGE_0>.

Up to 7 files · Accepts image/*

aspect_ratiostring

Frame shape of the generated video.

Default: 16:9

One of: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16

resolutionstring

Output resolution. Credits scale with resolution and length.

Default: 480p

One of: 480p, 720p

duration_secondsnumber

Video length in seconds, from 1 to 15.

Default: 8

Min 1 · Max 15