# Veo 3.1

> Generate stunning 8-second videos in 720p or 1080p at 24fps with native audio, multi-modal inputs (text, image, video), and cinematic-quality motion and character consistency.

## Overview

- **Model ID**: `veo-3.1`
- **Category**: video
- **Provider**: google
- **Status**: model_ready
- **Screenshot**: `https://assets.modelslab.com/generations/b30cbd29-18d9-435b-b33f-a33002468eac.webp`

## API Information

This model can be used via our HTTP API. See the API documentation and usage examples below.

### Endpoint

- **URL**: `https://modelslab.com/api/v7/video-fusion/text-to-video`
- **Method**: POST

### Parameters

- **`prompt`** (required): 
  - Type: textarea
  - Example: Enter prompt for video

- **`aspect_ratio`** (required): The aspect ratio of the generated video — 16:9 is wide, 9:16 for Vertical video generation 
  - Type: select (options: 16:9, 9:16)

- **`duration`** (required): Veo 3 models: 4, 6, or 8. The default is 8.
  - Type: select (options: 8s, 6s, 4s)

- **`generate_audio`** (required): Determines whether audio should be generated for the video. Default is true.
  - Type: toggle

- **`model_id`** (optional): model_id is required for selecting the right model for API
  - Type: text

- **`negative_prompt`** (optional): A negative prompt that specifies what should be avoided during video generation.
  - Type: textarea

- **`enhance_prompt`** (optional): Engance your given prompt. Default true
  - Type: toggle

## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://modelslab.com/api/v7/video-fusion/text-to-video \
  --header "Content-Type: application/json" \
  --data '{
    "key": "YOUR_API_KEY",
    "model_id": "veo-3.1",
    "prompt": "A wide, eye-level cinematic shot captures a man walking slowly across a frost-covered bridge at dawn, his hands tucked into the pockets of a heavy coat. Pale morning light glows faintly through soft, curling fog that clings to the bridge railings. In the distance, bare trees fade into the mist, their skeletal branches barely visible. The pace is unhurried and reflective, evoking a naturalistic and quiet mood. The scene is filled with subtle, atmospheric sounds—faint footsteps crunching on frost, steady breaths in the cold air, and the distant caw of a crow echoing across the stillness.",
    "aspect_ratio": "16:9",
    "duration": "8",
    "generate_audio": false,
    "negative_prompt": "example_negative_prompt",
    "enhance_prompt": false
  }'
```

### Python

```python
import requests

response = requests.post(
    "https://modelslab.com/api/v7/video-fusion/text-to-video",
    headers={
        "Content-Type": "application/json"
    },
    json={
        "key": "YOUR_API_KEY",
        "model_id": "veo-3.1",
        "prompt": "A wide, eye-level cinematic shot captures a man walking slowly across a frost-covered bridge at dawn, his hands tucked into the pockets of a heavy coat. Pale morning light glows faintly through soft, curling fog that clings to the bridge railings. In the distance, bare trees fade into the mist, their skeletal branches barely visible. The pace is unhurried and reflective, evoking a naturalistic and quiet mood. The scene is filled with subtle, atmospheric sounds—faint footsteps crunching on frost, steady breaths in the cold air, and the distant caw of a crow echoing across the stillness.",
        "aspect_ratio": "16:9",
        "duration": "8",
        "generate_audio": False,
        "negative_prompt": "example_negative_prompt",
        "enhance_prompt": False
    }
)

print(response.json())
```

### JavaScript

```javascript
fetch("https://modelslab.com/api/v7/video-fusion/text-to-video", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "key": "YOUR_API_KEY",
    "model_id": "veo-3.1",
    "prompt": "A wide, eye-level cinematic shot captures a man walking slowly across a frost-covered bridge at dawn, his hands tucked into the pockets of a heavy coat. Pale morning light glows faintly through soft, curling fog that clings to the bridge railings. In the distance, bare trees fade into the mist, their skeletal branches barely visible. The pace is unhurried and reflective, evoking a naturalistic and quiet mood. The scene is filled with subtle, atmospheric sounds—faint footsteps crunching on frost, steady breaths in the cold air, and the distant caw of a crow echoing across the stillness.",
    "aspect_ratio": "16:9",
    "duration": "8",
    "generate_audio": false,
    "negative_prompt": "example_negative_prompt",
    "enhance_prompt": false
  })
})
.then(response => response.json())
.then(data => console.log(data));
```

## Links

- [Model Playground](https://modelslab.com/models/Veo-3.1/veo-3.1)
- [API Documentation](https://docs.modelslab.com)
- [ModelsLab Platform](https://modelslab.com)