> ## 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-fast-generate-preview

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

{/* source_model_id: veo-3.1-fast-generate-preview */}

{/* source_updated_at: 1781740984 */}

**Model ID**

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

**Calling method:** async

# veo-3.1-fast-generate-preview API Usage Guide

## Overview

**Veo 3.1 Fast** is a preview variant optimized for quicker turnaround. It supports generating videos from text prompts, animating a single reference image, and two-frame guidance using first and last frames. Supports 16:9 and 9:16 aspect ratios, 4/6/8-second durations, 24 FPS.

## 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-fast-generate-preview",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
      "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                                          |
| `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-fast-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-fast-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-fast-generate-preview
```

### Example

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

## Get Model Information

### Endpoint

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

### Example

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/models/veo-3.1-fast-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-fast-generate-preview",
        "other-model-1",
        "other-model-2"
    ]
}
```

## Pricing

* **Pricing Type**: Video length based pricing
* **Unit Price**: \$0.15 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