Smart Reframe
studio-smart-reframeConvert a video to any aspect ratio with subject tracking, optional trim, and smooth camera pan.
Send a video URL and a target aspect ratio. The service trims the source if you pass start/end, tracks the subjects and action, and reframes each moment to keep the important content in view at the new shape. With smart_camera_pan on, the motion is smoothed for a natural look. The output keeps the original audio.
POST
/v1/proxy/studio-smart-reframeSmart reframing (async)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
videoUrl | string | required | Source video URL |
aspect_ratio | string | required | Target aspect ratio (e.g. 9:16, 1:1, 4:5) |
start | string | optional | Trim start (seconds or hh:mm:ss) |
end | string | optional | Trim end (seconds or hh:mm:ss) |
smart_camera_pan | boolean | optional | Turn on smooth camera panning |
curl -X POST https://api.cn8.io/v1/proxy/studio-smart-reframe \
-H "X-API-Key: <cn8_api_key>" \
-H "Content-Type: application/json" \
-d '{"videoUrl":"https://example.com/file","aspect_ratio":"value"}'Response
{
"status": "accepted",
"job_id": "job_reframe_abc",
"service": "studio-smart-reframe"
}
Poll the job endpoint until completed, then download the output video. Billed per second of processed video.