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

# vidu-q3-pro-t2v

> API usage guide for vidu-q3-pro-t2v.

{/* source_model_id: vidu-q3-pro-t2v */}

{/* source_updated_at: 1774903991 */}

**Model ID**

```bash theme={null}
vidu-q3-pro-t2v
```

**Calling method:** async

# Vidu Q3 Pro Text-to-Video API Usage Guide

## Overview

**Vidu Q3 Pro** is a text-to-video model designed to generate high-quality 1080p video content from descriptive prompts. It supports custom durations up to 16 seconds and optional audio generation. This model is hosted externally by Vidu and accessible via the GMI Cloud request queue.

## Authentication

All API requests require authentication using your API key. Include it 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": "vidu-q3-pro-t2v",
    "payload": {
      "prompt": "Cinematic shot of a futuristic city with flying vehicles, sunset lighting, high detail",
      "duration": 5,
      "audio": true,
      "seed": 42
    }
  }'
```

### Request Parameters

| Parameter  | Type    | Required | Description                             | Default | Constraints     |
| ---------- | ------- | -------- | --------------------------------------- | ------- | --------------- |
| `prompt`   | string  | Yes      | Text description of the desired video.  | -       | Max 2000 chars  |
| `duration` | integer | No       | Length of the video in seconds.         | 5       | Min: 1, Max: 16 |
| `audio`    | boolean | No       | Whether to include generated audio.     | false   | -               |
| `seed`     | integer | No       | Specific seed for reproducible results. | null    | -               |

### Response

```json theme={null}
{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "vidu-q3-pro-t2v",
  "status": "queued",
  "created_at": 1772184500
}
```

## Check Request Status

### Endpoint

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

### Response

```json theme={null}
{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "vidu-q3-pro-t2v",
  "status": "success",
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/gmi-generated-assets/.../vidu_output_0.mp4"
      }
    ]
  }
}
```

## Request Status Values

| Status       | Description                                |
| ------------ | ------------------------------------------ |
| `queued`     | Request is waiting in the queue            |
| `processing` | Video is currently being rendered          |
| `success`    | Video generation completed                 |
| `failed`     | Generation failed (check logs for details) |
| `cancelled`  | Request was manually cancelled             |

## Pricing

* **Pricing Type**: Per second of video
* **Price**: \$0.16 per second
* **Unit**: Video Second

## Tips for Better Results

1. **Prompt Detail**: Describe lighting, camera movement, and atmosphere for better cinematic results.
2. **Audio Sync**: Enabling audio works best when the prompt includes sound-producing elements (e.g., "thunderstorm", "crowded street").
3. **Consistency**: Use a fixed `seed` value if you want to tweak a prompt while keeping the general composition similar.