Reference
API reference
Complete input parameter surface for Grok Imagine v1.0. The canonical schema lives at the model's llms.txt; the table below is derived from it.
Endpoint
Submit a job to the queue endpoint:
POST https://queue.fal.run/xai/grok-imagine-video/text-to-videoInput parameters
| Key | Type | Default | Allowed / notes |
|---|---|---|---|
| promptrequired | string | — | Free text describing the output. |
| duration | number | 6 | 1 to 15, step 1 |
| resolution | enum | 720p | 480p | 720p |
| aspect_ratio | enum | 16:9 | 16:9 | 9:16 | 1:1 | 4:3 | 3:2 | 2:3 | 3:4 |
Canonical schema: fal.ai/models/xai/grok-imagine-video/text-to-video/llms.txt. Anything new shipped by the model vendor appears there first.
Worked example
Minimal request using the defaults above. Swap the prompt for your own; everything else stays optional.
BASH
1curl -X POST "https://queue.fal.run/xai/grok-imagine-video/text-to-video" \2 -H "Authorization: Key $FAL_KEY" \3 -H "Content-Type: application/json" \4 -d '{"prompt":"Dusk on a Brooklyn rooftop, string lights flickering. A woman in a denim jack...","duration":6,"resolution":"720p","aspect_ratio":"16:9"}'