> ## 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-v5.5-i2v

> API usage guide for pixverse-v5.5-i2v.

{/* source_model_id: pixverse-v5.5-i2v */}

{/* source_updated_at: 1782168274 */}

**Model ID**

```bash theme={null}
pixverse-v5.5-i2v
```

**Calling method:** async

# Pixverse v5.5 Image-to-Video API Usage Guide

## Overview

Pixverse v5.5 Image-to-Video (I2V) is an advanced model designed to animate static images using text guidance. It supports cinematic camera controls, high-quality motion consistency, and integrated audio generation to bring static frames to life.

## Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:
Authorization: Bearer YOUR\_API\_KEY

***

## Submit Video Generation Request

### Base URL

[https://console.gmicloud.ai](https://console.gmicloud.ai)

### Endpoint

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

### Request Format (cURL)

```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": "pixverse-v5.5-i2v",
    "payload": {
      "image_url": "https://example.com/source_image.jpg",
      "prompt": "The character turns their head and smiles, cinematic lighting",
      "negative_prompt": "distorted face, static, morphing",
      "duration": "5",
      "aspect_ratio": "16:9",
      "quality": "1080p",
      "style": "none",
      "thinking_type": "auto",
      "generate_audio_switch": true,
      "generate_multi_clip_switch": true
    }
  }'
```

### Request Parameters

| Parameter                     | Type    | Required | Description                               | Default | Constraints                          |
| ----------------------------- | ------- | -------- | ----------------------------------------- | ------- | ------------------------------------ |
| image\_url                    | string  | Yes      | URL of the source image (JPG, PNG, WebP). | -       | Must be a public URL.                |
| prompt                        | string  | Yes      | Description of the motion or action.      | -       | Describe the change.                 |
| negative\_prompt              | string  | No       | Elements to avoid in the animation.       | ""      | -                                    |
| duration                      | enum    | Yes      | Video length in seconds.                  | 5       | 5, 8, 10 (10s unavailable at 1080p). |
| aspect\_ratio                 | enum    | Yes      | Frame dimensions.                         | 16:9    | 16:9, 9:16, 1:1, 4:3, 3:4.           |
| quality                       | enum    | Yes      | Video resolution.                         | 540p    | 360p, 540p, 720p, 1080p.             |
| thinking\_type                | enum    | No       | Internal prompt reasoning.                | auto    | enabled, disabled, auto.             |
| generate\_audio\_switch       | boolean | No       | Generate synchronized SFX/BGM.            | false   | -                                    |
| generate\_multi\_clip\_switch | boolean | No       | Enable cinematic camera changes.          | false   | -                                    |
| seed                          | integer | No       | Seed for reproducibility.                 | -       | 0 - 2147483647.                      |

Visual Style Options: none (Default), anime, 3d\_animation, clay, comic, cyberpunk.

***

## Check Request Status

### Endpoint

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

### Example Response

```bash theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "pixverse",
  "model": "pixverse-v5.5-i2v",
  "status": "success",
  "payload": {
    "image_url": "https://example.com/source_image.jpg",
    "prompt": "The character turns their head..."
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-i2v-video.mp4"
  },
  "created_at": 1750442925,
  "updated_at": 1750442930
}
```

***

## Request Status Values

| Status     | Description                           |
| ---------- | ------------------------------------- |
| queued     | Request is waiting in the queue       |
| processing | Video is being animated               |
| success    | Animation complete; URL is in outcome |
| failed     | Request failed                        |
| cancelled  | Request was cancelled                 |