> ## 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.

# Vertex AI Veo

> Generate videos with Google Cloud Vertex AI and Veo 3.1

Generate videos using GA Veo 3.1 models through Google Cloud Vertex AI.

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import VideoAgent

agent = VideoAgent(llm="vertex_ai/veo-3.1-generate-001")
video = agent.start("Ocean waves at sunset", output="ocean.mp4")
```

## Authentication

Vertex AI supports two auth paths — pick the one that matches your setup.

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Option A: service account (CI / production)
export GOOGLE_APPLICATION_CREDENTIALS=path/to/service-account.json

# Option B: project + location (local dev with gcloud)
export VERTEXAI_PROJECT=your-project-id
export VERTEXAI_LOCATION=us-central1
```

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph TB
    Start[🔐 Choose auth path] --> Q{Where are you running?}
    Q -->|CI / production| SA[🔑 Service account<br/>GOOGLE_APPLICATION_CREDENTIALS]
    Q -->|Local dev with gcloud| PL[📍 Project + location<br/>VERTEXAI_PROJECT + VERTEXAI_LOCATION]

    classDef start fill:#8B0000,stroke:#7C90A0,color:#fff
    classDef decision fill:#F59E0B,stroke:#7C90A0,color:#fff
    classDef option fill:#189AB4,stroke:#7C90A0,color:#fff

    class Start start
    class Q decision
    class SA,PL option
```

> [!NOTE]
>
> Use a service account for CI and production. Use project + location for local
> development where you are already signed in with `gcloud`.

## Models

Three GA Veo 3.1 tiers cover cinematic quality down to cheap iteration.

| Model | Description |
| - | - |
| `vertex_ai/veo-3.1-generate-001` | Veo 3.1 GA Standard — cinematic quality |
| `vertex_ai/veo-3.1-fast-generate-001` | Veo 3.1 GA Fast — quicker, lower cost |
| `vertex_ai/veo-3.1-lite-generate-001` | Veo 3.1 Lite — cheapest iteration |

### Deprecated

Migrate to the `veo-3.1` IDs above. These older models are being retired.

| Model | Note |
| - | - |
| `vertex_ai/veo-2.0-generate-001` | Deprecated — migrate to `veo-3.1` |
| `vertex_ai/veo-3.0-generate-preview` | Deprecated — migrate to `veo-3.1` |
| `vertex_ai/veo-3.0-fast-generate-001` | Deprecated — migrate to `veo-3.1` |

## Veo 3.1 features

Veo 3.1 adds frame interpolation and reference images. Both pass straight through `generate()` — no extra setup.

> [tab] First + last frame
>
> ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> from praisonaiagents import VideoAgent
>
> agent = VideoAgent(llm="vertex_ai/veo-3.1-generate-001")
>
> # First + last frame interpolation (Veo 3.1)
> agent.generate(
>     prompt="Sunrise timelapse",
>     input_reference=start_image,  # first frame
>     last_frame=end_image,         # last frame
> )
> ```

> [tab] Reference images
>
> ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> from praisonaiagents import VideoAgent
>
> agent = VideoAgent(llm="vertex_ai/veo-3.1-generate-001")
>
> # Up to 3 reference images
> agent.generate(
>     prompt="A cinematic dolly shot of the character",
>     reference_images=[img1, img2, img3],
> )
> ```

## Pricing & billing

Vertex AI Veo bills per generated second in USD, charged through your connected GCP project.

> [!WARNING]
>
> Flow / AI Plus-Ultra subscription credits are a different meter and cannot pay
> for API generations. Vertex AI usage is billed via your GCP project.

## Parameters

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
video = agent.generate(
    prompt="Your description"
)
```

## Features

| Feature | Supported |
| - | - |
| Text-to-Video | ✅ |
| Image-to-Video | ✅ |
| First + last frame (Veo 3.1) | ✅ |
| Reference images (Veo 3.1) | ✅ |
| Video Remix | ❌ |
| GCP Integration | ✅ |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.