> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PixVerse V5.5 Transition API

> Generate first-to-last frame video transitions with PixVerse V5.5. Interpolate between two images with camera movement, native audio, and 5-10s durations.

## Overview

PixVerse V5.5 Transition is an image-to-video API that interpolates a video between two keyframes. Provide a `first_image_url` and an `end_image_url`, and PixVerse V5.5 generates a smooth transition between the two frames guided by your `prompt`. Both images are required. It supports camera movement presets, native synchronized audio, prompt reasoning, and 5, 8, or 10 second durations.

### Key capabilities

* **First-to-last frame transition**: interpolate between the required `first_image_url` and `end_image_url` in a single request
* **Camera movement presets**: 20 options including `zoom_in`, `zoom_out`, `pan_left`, `pan_right`, `crane_up`, `hitchcock`, `whip_pan`, `camera_rotation`
* **Native synchronized audio**: enable `generate_audio_switch` to produce music, sound effects, or dialogue together with the video
* **Prompt reasoning (`thinking_type`)**: choose `enabled` (default), `disabled`, or `auto` to control prompt rewriting
* **Duration (5, 8, or 10 seconds)**: `5` (default), `8`, or `10`; 8s costs double, 10s is available up to 720p, and 1080p is limited to 5 or 8 seconds
* **Resolutions**: `360p`, `540p`, `720p`, `1080p`
* **Aspect ratios**: `widescreen_16_9` (default), `classic_4_3`, `square_1_1`, `traditional_3_4`, `social_story_9_16`
* **Async processing**: poll the task endpoint or receive a webhook notification on completion

### Use cases

* **Story transitions**: scene-to-scene cuts and morphs that bridge two shots
* **Product reveals**: transition between a closed and open, or before and after, product state
* **Marketing and ads**: dynamic transitions with camera movement and synchronized audio
* **Social content**: vertical `social_story_9_16` transitions for TikTok, Instagram Reels, and YouTube Shorts
* **Creative experimentation**: stylized morphs (`anime`, `cyberpunk`, `clay`) between keyframes

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/image-to-video/pixverse-v5-5-transition" icon="video" href="/api-reference/image-to-video/pixverse-v5-5-transition/create">
      Generate a first/last frame transition with PixVerse V5.5
    </Card>

    <Card title="GET /v1/ai/image-to-video/pixverse-v5-5-transition/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-video/pixverse-v5-5-transition/task-by-id">
      Get task status and result by ID
    </Card>

    <Card title="GET /v1/ai/image-to-video/pixverse-v5-5-transition" icon="list" href="/api-reference/image-to-video/pixverse-v5-5-transition/pixverse-v5-5-transition-tasks">
      List all PixVerse V5.5 Transition tasks
    </Card>
  </Columns>
</div>

### Parameters

| Parameter               | Type           | Required | Default           | Description                                                                                           |
| ----------------------- | -------------- | -------- | ----------------- | ----------------------------------------------------------------------------------------------------- |
| `prompt`                | `string`       | Yes      | -                 | Prompt describing the video transition to generate                                                    |
| `first_image_url`       | `string` (uri) | Yes      | -                 | URL of the image to use as the first frame                                                            |
| `end_image_url`         | `string` (uri) | Yes      | -                 | URL of the image to use as the last frame                                                             |
| `resolution`            | `string`       | No       | -                 | Output resolution: `360p`, `540p`, `720p`, `1080p`                                                    |
| `aspect_ratio`          | `string`       | No       | `widescreen_16_9` | `widescreen_16_9`, `classic_4_3`, `square_1_1`, `traditional_3_4`, `social_story_9_16`                |
| `duration`              | `integer`      | No       | `5`               | Video length in seconds: `5`, `8`, or `10`. 8s costs double; 10s up to 720p; 1080p limited to 5 or 8s |
| `negative_prompt`       | `string`       | No       | `""`              | Negative prompt for the generation                                                                    |
| `style`                 | `string`       | No       | -                 | Visual style: `anime`, `3d_animation`, `clay`, `cyberpunk`, `comic`                                   |
| `seed`                  | `integer`      | No       | -                 | Reproducibility seed; same seed + same prompt yields the same video                                   |
| `camera_movement`       | `string`       | No       | -                 | Camera preset (e.g., `zoom_in`, `pan_left`, `crane_up`, `hitchcock`, `whip_pan`, `camera_rotation`)   |
| `generate_audio_switch` | `boolean`      | No       | `false`           | When `true`, generates synchronized audio (music, SFX, or dialogue) with the video                    |
| `thinking_type`         | `string`       | No       | `enabled`         | Prompt reasoning mode: `enabled`, `disabled`, or `auto`                                               |
| `webhook_url`           | `string` (uri) | No       | -                 | Optional callback URL that receives task status notifications                                         |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="How does the transition work?">
    Provide a `first_image_url` and an `end_image_url`. PixVerse V5.5 interpolates a video between the two frames using your `prompt` as guidance, producing the transition in a single request.
  </Accordion>

  <Accordion title="Is the end image required?">
    Yes. PixVerse V5.5 Transition requires both `first_image_url` (first frame) and `end_image_url` (last frame). Requests without an end frame are rejected.
  </Accordion>

  <Accordion title="Which durations and resolutions are supported?">
    PixVerse V5.5 Transition supports `5` (default), `8`, or `10` second durations and resolutions of `360p`, `540p`, `720p`, and `1080p`. 8-second videos cost double, 10-second videos are available up to 720p, and 1080p is limited to 5 or 8 seconds.
  </Accordion>

  <Accordion title="What camera movements are available?">
    20 presets are supported, including `zoom_in`, `zoom_out`, `pan_left`, `pan_right`, `crane_up`, `hitchcock`, `whip_pan`, and `camera_rotation`. Leave `camera_movement` unset for a static camera.
  </Accordion>

  <Accordion title="How does native audio generation work?">
    Set `generate_audio_switch` to `true` and PixVerse V5.5 produces synchronized audio (background music, sound effects, or dialogue) together with the video in a single request.
  </Accordion>

  <Accordion title="What are the rate limits and pricing?">
    Rate limits and pricing depend on your subscription tier. See [Rate Limits](/ratelimits) and the [Pricing page](/pricing) for current values.
  </Accordion>
</AccordionGroup>

## Best practices

* **Frame consistency**: choose two frames that share scene context (subject, framing, lighting) for the smoothest interpolation
* **Input quality**: provide sharp, well-lit images with a clear subject for the strongest motion and style stability
* **Camera movement**: combine a `camera_movement` preset with the transition for more dynamic results, or leave it unset for a clean morph
* **Duration selection**: use `5` seconds for most transitions to reduce cost; request 10s only at 720p or lower
* **Production integration**: use `webhook_url` instead of polling for scalable workflows
* **Error handling**: implement retry with exponential backoff for 503 responses

## Related APIs

* **PixVerse V6 Transition**: newer transition endpoint with flexible 1-15 second durations and multi-clip output. See the [PixVerse V6 Transition overview](/api-reference/image-to-video/pixverse-v6-transition/overview).
* **PixVerse V5.5 (image-to-video)**: animate a single image without a transition. See the [PixVerse V5.5 overview](/api-reference/image-to-video/pixverse-v5-5/overview).
* **PixVerse V5.5 Text to Video**: generate a video from a text prompt with no input image. See the [PixVerse V5.5 Text to Video overview](/api-reference/text-to-video/pixverse-v5-5/overview).
