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

# pixverse-v6-i2v

> API usage guide for pixverse-v6-i2v.

{/* source_model_id: pixverse-v6-i2v */}

{/* source_updated_at: 1780650820 */}

**Model ID**

```bash theme={null}
pixverse-v6-i2v
```

**Calling method:** async

# Pixverse v6 Image-to-Video API Documentation

## Overview

Pixverse v6 provides advanced image-to-video generation, supporting dynamic camera changes and multiple resolutions up to 1080p.

## Authentication

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

```
Authorization: Bearer YOUR_API_KEY
```

## Submit Image-to-Video Request

### Base URL

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

### Endpoint

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

### Request Format

```
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": "pixverse-v6-i2v",
    "payload": {
      "prompt": "A cinematic shot of a futuristic city at sunset.",
      "image": "https://example.com/start_frame.jpg",
      "duration": 5,
      "quality": "1080p",
      "generate_audio_switch": true
    }
  }'
```

### Request Parameters

| Parameter                    | Type    | Required | Description                                                  | Default |
| ---------------------------- | ------- | -------- | ------------------------------------------------------------ | ------- |
| `prompt`                     | string  | Yes      | Primary text prompt describing the video (up to 5000 chars). | ""      |
| `image`                      | image   | Yes      | Image upload for the video.                                  | null    |
| `duration`                   | integer | Yes      | Video length in seconds. 1-15s.                              | 5       |
| `quality`                    | enum    | Yes      | Video resolution (360p, 540p, 720p, 1080p).                  | "540p"  |
| `generate_audio_switch`      | boolean | No       | Automatically generate BGM and sound effects.                | false   |
| `generate_multi_clip_switch` | boolean | No       | Enable dynamic camera changes and transitions.               | false   |
| `seed`                       | integer | No       | Set a specific seed for reproducible results (0-2147483647). | null    |

### Response

```
{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "pixverse-v6-i2v",
  "status": "queued",
  "created_at": 1772184500
}
```

## Check Request Status

### Endpoint

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

### Response

```
{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "pixverse-v6-i2v",
  "status": "success",
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/gmi-generated-assets/.../pixverse_output_0.mp4"
      }
    ]
  }
}
```

## Request Status Values

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

## Pricing

* **Pricing Type**: Video length based pricing
* **Price**: 360p: $0.025($0.035 with audio). 540p: $0.035($0.045). 720p: $0.045(0.06). 1080p: $0.09(\$0.115)