What you say to the agent
No special syntax — just describe it like you would to a person.
What it does, step by step
- 1
List the images and/or videos in the order you want them, with a duration for each image and an optional trim range for each video.
- 2
Optionally add a picture-in-picture overlay video on top of the whole thing.
- 3
It concatenates everything in your given order and returns the merged video.
What it needs from you
- •The images/videos to combine, in order
What comes back
A single video merging every item you listed, in order, with any overlay applied.
What it costs
A flat per-video processing fee, shown before rendering.
Under the hood
This is what the agent actually calls when you ask for it — real tools from its live surface, not marketing copy.
compose_video_with_overlayMERGE/STITCH multiple media items (images, videos, or any mix) into a single final video, with an OPTIONAL picture-in-picture overlay video on top. PRIMARY use cases: (A) Merge user-uploaded images + an existing video into one video (e.g. user uploads photos and wants them stitched onto a clip). (B) Merge multiple videos with optional per-clip range trims (e.g. clip A seconds 3-8, then clip B seconds 0-5, then clip C). (C) Stitch a series of images each held on screen for a custom duration (slideshow-style). (D) Any of the above with a corner picture-in-picture overlay video composited on top. Each base item is { kind: 'image' | 'video', url, duration_sec?, start_sec?, end_sec? }. For 'image' items: duration_sec is REQUIRED (seconds the image stays on screen). start_sec / end_sec are ignored. For 'video' items you may EITHER pass duration_sec (trim from start to N seconds) OR pass start_sec + end_sec (keep the [start_sec, end_sec) range — both must be set together). If neither is set the video plays end-to-end. Items are concatenated in the array order. Omit overlay_video_url to just stitch the base. Use this INSTEAD of create_ugc_video_overlay whenever the base is more than a single video, when combining images with videos, or when you need per-clip range trims as part of the merge.
See it done in a real workflow
Morning Matcha Routine
UGC-style wellness reel — a clean-girl creator walks through her actual morning matcha ritual, then cuts to a cozy animated hero shot of the finished iced latte.
TrendingNYC Street Interview
Photorealistic street-vlog interview — Riley works three different NYC corners at golden hour asking strangers one question: "What's the wildest thing you've ever done?" Three candid OTS/two-shot clips with locked character references, real handheld energy and native spoken dialogue. Vertical 9:16.
TrendingPrimo Protein vs Other Brand
Pixar-style 3D comparison ad — the confident PRIMO PROTEIN pouch faces off against the tired old rival brand's tub across 11 talking clips: pasture vs dusty pantry, herb garden vs toxic lab, clean American lab vs grimy factory, chocolate-milkshake CTA vs "wet sand." ~40s vertical reel with native character voices.
Or start from a one-tap template
Frequently asked questions
What do I actually say to the agent to stitch multiple clips into one video?+
Just describe it in plain English — for example: "Merge these 3 photos and this video clip into one video, 2 seconds per photo" The agent handles picking the right tool and model from there.
What does the agent need from me first?+
At minimum: The images/videos to combine, in order. Anything else it needs, it asks for before running.
What do I get back?+
A single video merging every item you listed, in order, with any overlay applied.
Does this cost credits?+
A flat per-video processing fee, shown before rendering.
You can also just ask for
Ask your Versely agent to stitch multiple clips into one video
The all-in-one AI studio for creators. 60+ models for video, image, voice, music and lipsync in a single app.