API docs / Video models

Grok Imagine Video API

Generate videos using xAI's Grok Imagine Video model

Model id
xai/grok-imagine-video
Provider
xai
Output
Video
Price
From 88 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". 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",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light"
  },
  "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

Text prompt for video generation

first_framearray of URLs

Input image to generate video from (image-to-video). Supports jpg, jpeg, png, webp.

Up to 1 files · Accepts image/*

source_videoarray of URLs

Input video to edit (video editing mode). Must be a direct link, max 8.7 seconds. Supports mp4, mov, webm. Each file: up to 8.7s.

Up to 1 files · Accepts video/*

aspect_ratiostring

Default: auto

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

resolutionstring

Default: 720p

One of: 720p, 480p

duration_secondsnumber

Duration of the video in seconds (1-15). Ignored when editing a video.

Default: 5

Min 1 · Max 15