edit_video is Versely's flagship agent-driven editor: one call can stitch multiple clips, apply transitions, add text overlays, mix in music and voiceover, layer a picture-in-picture overlay, and burn captions — instead of chaining cut_video, attach_audio_to_video and a captioning tool separately, prefer this whenever you want a multi-clip assembly done in one step.
Its own description recommends exactly this: 'Prefer this over chaining cut_video + attach_audio + add_*_captions when the user wants a multi-clip assembly in a single step.'
Powered by
Agent-driven EDL render via the Versely editor pipeline (POST /features/editor-render). Stitch, trim, speed-change, caption, overlay, and mix user media (workspace/generation HTTPS URLs) into ONE final video. Prefer this over chaining cut_video + attach_audio + add_*_captions when the user wants a multi-clip assembly in a single step. Billing: preview:true is free 480p (per-user cooldown); final export (preview:false, default) charges the normal single editor_export price. Prefer preview:true while the user is iterating; only final-render after confirmation. Clips must be HTTPS URLs (file:// and other schemes rejected). Returns { video_url, credits_charged, preview_notes } or a 402-style insufficient-credits error.
What to tell the agent
Versely's agent maps this plain-English request directly onto edit_video. You don't need to know the parameter names — just describe what you want.
“Edit these three clips together with a crossfade transition, add background music at low volume, and burn in captions — export at 9:16 for TikTok.”
How it works
1. List your clips
clips (HTTPS URLs, required) is the ordered list of media to stitch together — the only required field.
2. Layer in the extras
transition/transition_duration between clips, texts for on-screen text, music and voiceover for audio, overlay for a PiP layer, and captions to burn in subtitles — all optional, all in the same call.
3. Set the output format
aspect_ratio and resolution control the final export shape and quality.
4. Preview, then export
preview:true gives a free 480p render (per-user cooldown) for iterating; the default preview:false final export charges the normal single editor_export price once you confirm.
What it costs
Free 480p preview while iterating (preview:true, per-user cooldown); the final export (preview:false, the default) charges the standard editor_export price regardless of how many features (music, captions, overlay) you stacked into the one call.
The formula behind that number: What does editing a video cost if I keep changing it? — charges per finished export, so iteration is free and the count is the whole bill.
Limits & things to know
- Clips must be HTTPS URLs — file:// and other local schemes are rejected.
- It returns { video_url, credits_charged, preview_notes } or a 402-style error if you don't have enough credits — check balance with check_credits first for a big job.
- Iterate with preview:true; only run the final (paid) render after you've confirmed the edit looks right.
Who uses this
- A single-call full assembly: multiple clips + music + captions + export ratio
- UGC ads that need clips, a PiP talking head, and captions together
- Turning a raw multi-clip shoot into a finished, platform-ready video in one job
Frequently asked questions
Why use this instead of chaining several separate tools?+
edit_video's own description recommends it specifically for multi-clip assemblies — one call handles stitching, transitions, text, music, voiceover, overlay and captions together, instead of manually chaining cut_video, attach_audio_to_video and a captioning tool.
Can I check the edit before it costs credits?+
Yes — set preview:true for a free 480p render (subject to a per-user cooldown) before running the final, credit-charged export.
What if I don't have enough credits?+
The final export returns a 402-style insufficient-credits error rather than partially charging — check your balance with check_credits before a large job.
Related Versely tools
Related editing jobs
Edit a Video With Music and Captions in One Pass inside Versely
The all-in-one AI studio for creators. 60+ models for video, image, voice, music and lipsync in a single app.