falImage to videoAvailable now

xai/grok-imagine-video/v1.5/reference-to-video

xai/grok-imagine-video/v1.5/reference-to-video is an image to video tool from fal that runs in the background and returns video. Pay as you go from $0.013 per image, with one API key.

Try itfrom $0.013 / image

Pricing

resolution: 480p (default) $0.104, 720p $0.182 per second. Each item in reference_image_urls adds $0.013. Billed on duration, default 8. The final charge comes from usage.

Limits

Runs
In the background
Returns
video
Longest queue wait
3600s
Run deadline
3600s
Largest inline input
1024 KB
Largest input file
500 MB
Largest output
4768 MB
Outputs per run
16

Input

FieldKindDefaultDescription
prompt requiredtext—Text prompt describing the video. Tag references as <IMAGE_0>, <IMAGE_1>, etc.
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 <IMAGE_0>, <IMAGE_1>, etc. Maximum 7 images.
durationnumber (whole)
1 to 15
8Video duration in seconds.
resolutionone of
480p, 720p
480pResolution of the output video.
aspect_ratioone of
16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16
16:9Aspect 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/v1.5/reference-to-video",
    "input": {
      "prompt": "The person from <IMAGE_0> walks through a rainy neon-lit street.",
      "reference_image_urls": [
        "<reference_image_urls>"
      ]
    }
  }'