Skip to main content
POST
Reframe video to different aspect ratio
Reframe a video to a different aspect ratio (e.g., 16:9 to 9:16 for vertical content). The system intelligently tracks subjects to keep them in frame.
  • Reframing is asynchronous; use the status endpoint to track progress
  • target specifies the desired aspect ratio (e.g., 9:16, 1:1, 4:3)
  • mode controls the reframing strategy (e.g., auto for intelligent subject tracking)
  • Use callback_url for webhook notification when reframing completes

Get Reframe Status

Check reframe job progress

Aspect Ratio Guide

Learn about aspect ratio control

Authorizations

x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

video_id
string
required
Pattern: ^m-
Example:

"m-12345"

Body

application/json
target
string
required
Example:

"9:16"

mode
string
required
Example:

"auto"

start
number
default:0
Example:

0

end
number
Example:

30

callback_url
string
Example:

"https://webhook.example.com/callback"

callback_data
object

Response

200 - application/json

Reframe job started

success
boolean
Example:

true

status
enum<string>
Available options:
processing,
done,
failed
Example:

"processing"

data
object