Grok Imagine Reference to Video
xai/grok-imagine-video/reference-to-videoTurn 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
| Field | Kind | Default | Description |
|---|---|---|---|
prompt required | text | — | Text prompt describing the video to generate. Use @Image1, @Image2, etc. to reference specific images from reference_image_urls in order. |
reference_image_urls required | URLs 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. |
duration | number (whole) 1 to 10 | 8 | Video duration in seconds. |
resolution | one of 480p, 720p | 480p | Resolution of the output video. |
aspect_ratio | one 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.