Skip to main content
This guide shows you how to generate a video that begins on a first frame image and finishes on an end frame image. The model animates the change between the two, guided by your prompt. It is the natural fit for morphs, reveals, before-and-after shots, and joining two stills into one motion.

What You Will Build

Two Anchored Frames

Fix both the opening and the closing image of the clip

Directed Motion

Describe how the scene should travel from one frame to the other

Seamless Joins

Bridge two separately generated stills or clips with one transition

Chainable

Use the end frame as the first frame of the next request

Before You Begin

Make sure you have:
  • A Pictory API key
  • Node.js or Python installed on your machine
  • The required packages installed
  • Publicly accessible URLs for both the first frame and the end frame image
First and end frame transitions are supported by pixverse6 and pixverse5.6. Both frames should share the same aspect ratio; the output follows the frames.

Step-by-Step Guide

Step 1: Set Up Your Request

Prepare your API credentials, the two frame URLs, and a prompt that describes the motion between them.
endFrameImageUrl requires firstFrameImageUrl. Neither can be combined with extendVideoUrl or referenceImageUrls. Sending endFrameImageUrl on a model without transition support returns a 400 validation error before any credits are reserved.

Step 2: Submit the Video Generation Request

Send the request to the AI Studio video generation endpoint.

Step 3: Poll for the Result

Check the job status at regular intervals until the video is ready.

Understanding the Parameters

Input Frames and the Delivered Last Frame

Two similarly named fields mean different things:
  • endFrameImageUrl is the image you send. The generated video ends on it.
  • lastFrameImageUrl is returned on the completed job and in Get Generated Videos. It is the last frame extracted from the delivered video, ready to use as the firstFrameImageUrl of a follow-up request.
For a transition the two will look alike, but only the returned one is guaranteed to match the delivered file pixel for pixel.

Tips for Transitions

  • Describe the journey, not the endpoints. The frames already fix where the clip starts and ends. Spend the prompt on what happens in between: the camera move, the pace, and the order in which things change.
  • Keep the frames compatible. Similar framing, lighting, and aspect ratio between the two images give the model less to reconcile and produce smoother motion.
  • Generate the frames first. Use the Generate Image API with reference images to produce a consistent “before” and “after” still, then animate between them here.
  • Pick the duration for the distance. Small changes read well at 5s; a large scene change benefits from 8s or 10s.

Next Steps