video
Generate videos from a text prompt (or image+text prompt for models that
support image-to-video). Uses AI SDK experimental_generateVideo under the hood.
Agent note: video generation can be slow. When invoking this command from
automation, use a command timeout of at least 5 minutes.
Usage
1egaki video <prompt>
Arguments
| Argument | Required | Description |
<prompt> | Yes | prompt |
Options
| Option | Default | Description |
-m, --model [model] | - | Video model ID for generation. If omitted, shows an interactive picker (or uses default in non-TTY mode) |
-o, --output [path] | egaki-output.mp4 | Output file path (index suffix added when generating multiple) |
-n, --count [n] | 1 | Number of videos to generate |
--aspect-ratio [ratio] | - | Video aspect ratio in WIDTH:HEIGHT format (e.g. 16:9, 9:16) |
--resolution [resolution] | - | Video resolution. xai: 480p, 720p (default: 720p). bytedance: 480p, 720p, 1080p. Google: 720p, 1080p, 4k |
--duration [seconds] | - | Video duration in seconds. Veo: 4-8s. xAI Grok: 1-15s. Kling: 5-10s. Wan: 2-15s |
--fps [fps] | - | Frames per second for video models that support fps override |
--seed [seed] | - | Seed for reproducible video generation (model support varies) |
-i, --input [file] | - | Input file for video generation. For i2v: a reference image. For edit-video/extend-video: a source video. Accepts local file paths or URLs |
--mode [mode] | - | Video operation mode. xai: edit-video, extend-video, reference-to-video |
--reference-images [path] | - | Reference images for R2V generation, repeatable. xAI: 1-7 images. Seedance: 1-9 images (use @Image1 etc. in prompt) |
--negative-prompt [text] | - | Describe what to avoid in the generated video (Fal models) |
--json | - | Output result metadata as JSON to stdout (model, usage, warnings, file paths) |
--stdout | - | Write raw video bytes to stdout instead of saving to a file. Useful for piping to other tools |
Global Options
| Option | Default | Description |
-h, --help | - | Display this message |
-v, --version | - | Display version number |
Examples
1# Generate a video
1egaki video "A paper airplane gliding through clouds" -o airplane.mp4
1# Generate with Veo model + duration
1egaki video "cinematic rainy street at night" -m veo-3.1-fast-generate-001 --duration 6
1# Route through Vertex AI (Google Cloud billing)
1egaki video "storm over mountains" -m vertex/veo-3.1-fast-generate-001 --duration 6
1# Image-to-video (model support required)
1egaki video "animate subtle camera pan" --model luma-ray-2 --input frame.png -o animated.mp4
1# Generate multiple videos
1egaki video "waves crashing on cliffs" -n 2 -o waves.mp4