Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable now

Grok Imagine Reference to Video

xai/grok-imagine-video/reference-to-video

Turn images into video with Grok Imagine Reference to Video from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.

Pricing

resolution: 480p (default) $0.065, 720p $0.091 per second. Billed on duration, default 8.

Limits

Runs
In the background
Returns
video
Longest queue wait
1 hour
Run deadline
1 hour
Longest run, end to end
930 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

Text prompt describing the video to generate. Use @Image1, @Image2, etc. to reference specific images from reference_image_urls in order.

reference_image_urls requiredURLs or files—

One or more reference image URLs to guide the video generation as style and content references. Reference in prompt as @Image1, @Image2, etc. Maximum 7 images.

durationnumber (whole)
1 to 10
8

Video duration in seconds.

resolutionone of
480p, 720p
480p

Resolution of the output video.

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

Aspect ratio of the generated video.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "xai/grok-imagine-video/reference-to-video",
    "input": {
      "prompt": "A @Image1 running through a sunlit meadow, cinematic slow motion",
      "reference_image_urls": [
        "<reference_image_urls>"
      ]
    }
  }'

Frequently asked questions

How much does Grok Imagine Reference to Video cost?

`resolution`: 480p (default) $0.065, 720p $0.091 per second. Billed on `duration`, default 8. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Grok Imagine Reference to Video through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "xai/grok-imagine-video/reference-to-video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Grok Imagine Reference to Video?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Grok Imagine Reference to Video?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.