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
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:endFrameImageUrlis the image you send. The generated video ends on it.lastFrameImageUrlis returned on the completed job and in Get Generated Videos. It is the last frame extracted from the delivered video, ready to use as thefirstFrameImageUrlof a follow-up request.
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 from8sor10s.
Next Steps
- Generate Video from First Frame to animate from a single starting image
- Generate Video from Reference Images to keep subjects consistent across clips
- Generate Video with Audio to add sound to the transition
- Generate Video API Reference for the complete parameter documentation
