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

# veo-3.1-generate-preview

> API usage guide for veo-3.1-generate-preview.

**Model ID**

```bash theme={null}
veo-3.1-generate-preview
```

**Calling method:** async

# veo-3.1-generate-preview API Usage Guide

## Overview

**Veo 3.1** is Google's latest video generation model in preview. It supports generating videos from text prompts, animating a single reference image, and generating videos guided by both a first and last frame. It offers 16:9 and 9:16 aspect ratios, durations of 4/6/8 seconds, and produces 24 FPS videos at 720p or 1080p (availability may vary by feature).

## Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Video Generation Request

### Base URL

```
https://console.gmicloud.ai
```

### Endpoint

```
POST /api/v1/ie/requestqueue/apikey/requests
```

### Request Format

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-preview",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
      "reference_image": "https://example.com/reference_image.jpg",
      "image": "https://example.com/image.jpg",
      "lastFrame": "https://example.com/lastFrame.jpg",
      "durationSeconds": 6,
      "aspectRatio": "16:9",
      "generateAudio": true,
      "negativePrompt": "blurry, low quality, distorted",
      "personGeneration": "allow_all",
      "seed": 0
    }
  }'
```

### Request Parameters

| Parameter | Type | Required | Description | Default | Constraints |
| - | - | - | - | - | - |
| `prompt` | string | Yes | Text description of the video to generate (max 2000 characters). Describe scenes, actions, camera moves, and visual style. | - | Required |
| `reference_image` | string | No | Provide up to three images of a single person, character, or product. Veo preserves the subject's appearance in the output video.The aspect ratio MUST be 16:9 if a reference image is provided. Reference images will be ignored if a frame image is provided. Supported formats: jpeg, png, webp. | - | Max 3 images |
| `image` | string | No | Optional first frame for two-frame guided video generation. Supported formats: JPEG/PNG/WebP. | - | Max 1 image |
| `lastFrame` | string | No | Optional last frame for two-frame guided video generation. Supported formats: JPEG/PNG/WebP. | - | Max 1 image |
| `durationSeconds` | integer | No | Video length in seconds (4, 6, or 8). Reference image to video only supports 8 seconds. | 6 | Options: "4, 6, 8 |
| `aspectRatio` | string | No | Aspect ratio of the generated video. Some features may restrict supported aspect ratios. | "16:9" | Options: "16:9", "9:16" |
| `generateAudio` | boolean | No | Whether generate audio. | true | Optional |
| `negativePrompt` | string | No | Describe what you don't want to see in the video (max 500 characters). | - | Optional |
| `personGeneration` | string | No | Control whether people can appear in the video. | "allow\_all" | Options: "allow\_all", "allow\_adult", "disallow" |
| `seed` | integer | No | Random seed for reproducibility. Leave empty for random results. | - | Range: 0 to 4294967295 |

### Response

```json theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "veo-3.1-generate-preview",
  "status": "queued",
  "created_at": 1750442925,
  "updated_at": 1750442925,
  "queued_at": 1750442925
}
```

## Check Request Status

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

### Example

```bash theme={null}
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "your-org-id",
  "user_id": "your-user-id",
  "model": "veo-3.1-generate-preview",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
    "reference_image": "https://example.com/reference_image.jpg",
    "image": "https://example.com/image.jpg",
    "lastFrame": "https://example.com/lastFrame.jpg",
    "durationSeconds": 6,
    "aspectRatio": "16:9",
    "generateAudio": true,
    "negativePrompt": "blurry, low quality, distorted",
    "personGeneration": "allow_all",
    "seed": 0
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
    "thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
  },
  "created_at": 1750442925,
  "updated_at": 1750442930,
  "queued_at": 1750442925
}
```

## Request Status Values

| Status | Description |
| - | - |
| `queued` | Request is waiting to be processed |
| `processing` | Video generation is in progress |
| `success` | Video generation completed successfully |
| `failed` | Video generation failed |
| `cancelled` | Request was cancelled |

## List Your Requests

### Endpoint

```
GET api/v1/ie/requestqueue/apikey/requests?model_id=veo-3.1-generate-preview
```

### Example

```bash theme={null}
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=veo-3.1-generate-preview" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Get Model Information

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/models/veo-3.1-generate-preview
```

### Example

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/models/veo-3.1-generate-preview" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## List Available Models

### Endpoint

```
GET /api/v1/apikey/models
```

### Example

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
    "model_ids": [
        "veo-3.1-generate-preview",
        "other-model-1",
        "other-model-2"
    ]
}
```

## Pricing

* **Pricing Type**: Video length based pricing
* **Unit Price**: \$0.40 per second

## Tips for Better Results

1. **Clear, Descriptive Prompts**: Use specific, detailed descriptions for better video quality
2. **Negative Prompts**: Specify unwanted elements to improve quality


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