Content-aware reframing
The service tracks subjects and action and keeps the important content in view as it reframes to the target aspect ratio.
CatalogLatency Async; depends on video duration and resolution Async true Rate Limit Per API key Max Input Standard video durations and resolutions
cn8/studio-smart-reframe
Send a video URL and a target aspect ratio (e.g. 9:16, 1:1, 4:5). The service finds
Learn more about Smart Reframe Videoasync (job)Instant previewvideoprocessingstudio
Try it
Source video (landscape works best)
Target aspect
Result
The result shows up here
Upload your video on the left and hit Run.
Overview
Send a video URL and a target aspect ratio (e.g. 9:16, 1:1, 4:5). The service finds the subjects and action in your video and reframes each moment so the important content stays in view at the new shape — perfect for turning a horizontal video into a vertical one without cutting off the subject. You can optionally trim the video (start/end) to process just a portion, and turn on smooth camera panning for natural, cinematic motion. This is an async job: submit it, poll until it's ready, then download the reframed video.
Key capabilities
Any aspect ratio
Target any standard shape: 9:16 (vertical/Reels/TikTok), 1:1 (square/Instagram), 4:5 (portrait), 16:9 (horizontal), or a custom W:H.
Optional trim
Pass start and/or end (seconds or hh:mm:ss) to process only part of the video. This shortens the output and lowers the cost.
Smooth camera pan
Optionally turn on smooth panning so the reframe glides naturally between positions instead of cutting abruptly.
When to use it
Social vertical clips
Turn 16:9 horizontal video into 9:16 vertical for Reels, TikTok, or Shorts, keeping the subject in frame.
Multi-format delivery
Produce square (1:1) and portrait (4:5) versions from one horizontal master.
Clip extraction
Trim and reframe in one step: pull a 30-second highlight from a long video and reframe it for vertical.
Input & output
input
Video URL, target aspect ratio, optional start/end for trim, optional smart_camera_pan
JSON body
output
Reframed video URL (async job result)
JSONmedia URL
Guides & tips
How it works
- Submit a video URL and a target aspect ratio. Pass start/end to process only part of the video.
- The service tracks the subjects and action and reframes each moment to keep the important content in view at the new shape. The original audio is kept.
- With smart_camera_pan on, the reframe glides smoothly between positions for natural, cinematic motion instead of abrupt jumps.
- Because it processes the whole video, this is an async job — submit it, poll until it's ready, then download the result.
Trim rules
- start + end: process the [start, end] range.
- start only: process from start to the end of the video.
- end only: process from the beginning up to end.
- Neither: process the entire video.
Aspect ratio examples
- 9:16: vertical (Reels, TikTok, Shorts)
- 1:1: square (Instagram feed)
- 4:5: portrait (Instagram portrait)
- 16:9: horizontal (YouTube, standard)
Specs
Schema
Request body
videoUrlrequiredstringURL of the source video
aspect_ratiorequiredstringTarget aspect ratio (e.g. 9:16, 1:1, 4:5)
startstringOptional trim start: seconds (number) or hh:mm:ss. Processing begins from this point.
endstringOptional trim end: seconds (number) or hh:mm:ss. Processing ends at this point.
smart_camera_panbooleanTurn on smooth camera panning for natural-looking reframing motion.
Pricing
Billed per second of source video (after trim if applied). Two-part tariff: 5 credits base fee per job + 4 credits/second, minimum 5 billed seconds. Failed jobs are not billed.
| Service | Unit | Price |
|---|---|---|
| Smart Reframe | second | 4 credits/second |
Trimming with start/end shortens the processed segment and lowers the billed duration.