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

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

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

{/* source_updated_at: 1782168314 */}

**Model ID**

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

**Calling method:** async

# Pixverse v5.5 Transition API Usage Guide

## Overview

Pixverse v5.5 Transition allows for morphing effects and seamless scene evolutions by specifying a starting and an ending image. The model creates fluid intermediate frames to produce a transformation guided by a transition prompt.

## 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-transition",
    "payload": {
      "first_frame_image": "https://example.com/start.jpg",
      "last_frame_image": "https://example.com/end.jpg",
      "prompt": "A seed growing rapidly into a giant oak tree, timelapse style",
      "negative_prompt": "flickering, low quality, morphing artifacts",
      "duration": "5",
      "quality": "1080p",
      "generate_audio_switch": true
    }
  }'
```

### Request Parameters

| Parameter               | Type    | Required | Description                                         | Default | Constraints                          |
| ----------------------- | ------- | -------- | --------------------------------------------------- | ------- | ------------------------------------ |
| first\_frame\_image     | string  | Yes      | URL of the image to be the first frame.             | -       | JPG, PNG, WebP.                      |
| last\_frame\_image      | string  | Yes      | URL of the image to be the last frame.              | -       | Requires first\_frame\_image.        |
| prompt                  | string  | Yes      | Describes the transformation connecting the images. | -       | Max 2048 chars.                      |
| negative\_prompt        | string  | No       | Elements to exclude from the transition.            | ""      | -                                    |
| duration                | enum    | Yes      | Video length in seconds.                            | 5       | 5, 8, 10 (10s unavailable at 1080p). |
| quality                 | enum    | Yes      | Video resolution.                                   | 540p    | 360p (Turbo), 540p, 720p, 1080p.     |
| generate\_audio\_switch | boolean | No       | Generate synchronized audio/SFX.                    | false   | -                                    |
| seed                    | integer | No       | Seed for reproducibility.                           | -       | 0 - 2147483647.                      |

***

## 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-transition",
  "status": "success",
  "payload": {
    "first_frame_image": "...",
    "last_frame_image": "...",
    "prompt": "A seed growing into an oak tree"
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-transition.mp4"
  },
  "created_at": 1750442925,
  "updated_at": 1750442930
}
```

***

## Request Status Values

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