$ grokimagineapi
$playground--model=xai/grok-imagine-video/text-to-video
[ Grok Imagine v1.0 ]
[ AUTH / 401 ]
$ whoami
anonymous
$ exec grok-imagine-v1.0.run
STDERR: missing FAL_KEY
STDERR: set your key in settings to run live
$ help --auth
> Key stays in your browser. Billed to your own fal account. Never sent to our server.
[ GET KEY ]
prompt.shtty0
$
> Grok Imagine v1.0

# auth required: add FAL_KEY in settings

[ SCENE 08 / INTEGRATION ]
$ man integrate

> ship grok imagine v1.0 into your stack

> Same endpoint as the playground. Pick your shell. Copy. Run.

╔══════════════════════╦════════════════════════════════════════╗
║  endpoint            ║  xai/grok-imagine-video/text-to-video  ║
║  output              ║  video                                 ║
╚══════════════════════╩════════════════════════════════════════╝
$ cat main.tsTS
TS
1import { fal } from "@fal-ai/client";
2

3fal.config({ credentials: process.env.FAL_KEY });
4

5const { data } = await fal.subscribe("xai/grok-imagine-video/text-to-video", {
6  input: {
7    "prompt": "Dusk on a Brooklyn rooftop, string lights flickering. A woman in a denim jacket...",
8    "duration": 6,
9    "resolution": "720p",
10    "aspect_ratio": "16:9"
11  },
12  logs: true,
13});
14

15console.log(data);
$ cat main.pyPY
PYTHON
1import fal_client
2

3result = fal_client.subscribe(
4    "xai/grok-imagine-video/text-to-video",
5    arguments={
6      "prompt": "Dusk on a Brooklyn rooftop, string lights flickering. A woman in a denim jacket...",
7      "duration": 6,
8      "resolution": "720p",
9      "aspect_ratio": "16:9"
10    },
11    with_logs=True,
12)
13

14print(result)
$ cat curl.shSH
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 jacket...", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9" }'
[ --inputs --list ]
keykinddefaultoptions
--prompttext (required)·primary generation input
--durationnumber61..15
--resolutionselect720p480p | 720p
--aspect_ratioselect16:916:9 landscape | 9:16 portrait | 1:1 square | 4:3 classic | 3:2 photo | 2:3 portrait | 3:4 portrait

# schema fal.ai/models/xai/grok-imagine-video/text-to-video/llms.txt

Also reading