> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Videos CLI

> CLI commands for video generation

Generate a video from a text prompt on the command line.

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
    subgraph "praisonai videos"
        Prompt[📝 Prompt] --> CLI[🎬 videos]
        CLI --> Video[✅ MP4]
    end

    classDef input fill:#6366F1,stroke:#7C90A0,color:#fff
    classDef process fill:#189AB4,stroke:#7C90A0,color:#fff
    classDef output fill:#10B981,stroke:#7C90A0,color:#fff

    class Prompt input
    class CLI process
    class Video output
```

## Quick Start

<Steps>
  <Step title="Generate a video">
    Omit `--model` to use the canonical default `openai/sora-2`.

    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai videos "A cat playing with yarn"
    ```
  </Step>

  <Step title="Save to a file">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai videos "A sunset over the ocean" --output sunset.mp4
    ```
  </Step>
</Steps>

***

## Options

| Option     | Short | Default         | Description                     |
| ---------- | ----- | --------------- | ------------------------------- |
| `--model`  | `-m`  | `openai/sora-2` | Provider-prefixed LiteLLM route |
| `--output` | `-o`  | `None`          | Output file path                |

Only `--model` and `--output` are configurable on the CLI today.

***

## Examples

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Use the default model
praisonai videos "A futuristic cityscape at night"

# Pick a specific model
praisonai videos "A detailed portrait" -m openai/sora-2-pro

# Save the result to disk
praisonai videos "A waterfall in a forest" -o waterfall.mp4
```

***

## Related

<CardGroup cols={2}>
  <Card title="Videos" icon="video" href="/docs/capabilities/videos">
    The Python `video_generate` API.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/docs/cli/cli-reference">
    All PraisonAI CLI commands.
  </Card>
</CardGroup>