Reframe Video
Change a video’s aspect ratio without re-generating it (metered; long-running).
One video in, the same shot at a new framing out — the newly exposed edges are painted in rather than cropped to. The input is never modified and the result records it as its lineage parent. No prompt and no model choice: the serving engine is a Moda-side table entry.
Like generate-video, the provider render runs within this call (can take
minutes). The response’s applied block reports the framing and
resolution actually rendered; adjustments lists any snap away from the
exact ask. Inputs whose estimate exceeds the per-reframe cost ceiling are
rejected before anything is paid for.
Authorizations
API key from Settings > Developer > REST API
Headers
Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.
2026-04-12, 2026-05-01 "2026-05-01"
Body
The video to reframe: a file_ id from an upload or an http(s) video URL.
The framing to deliver: one of 16:9, 5:4, 1:1, 4:5, 9:16. Required — it is the request.
One of 720p, 1080p. 720p costs half as much as 1080p.
Keys the provider-job checkpoint: a retried call with the same key resumes the existing reframe instead of paying for a duplicate.
200Response
Successful Response
The response is of type Response Mediareframevideo · object.