media

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.

post/media/reframe-video

Request

  • Base URL
    https://api.moda.app/v1
  • URL
    https://api.moda.app/v1/media/reframe-video
  • Auth
    HTTP bearer

Headers

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

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.

Request body

videostring required

The video to reframe: a file_ id from an upload or an http(s) video URL.

aspect_ratiostring required

The framing to deliver: one of 16:9, 5:4, 1:1, 4:5, 9:16. Required — it is the request.

resolutionstring

One of 720p, 1080p. 720p costs half as much as 1080p.

idempotency_keystring nullable

Keys the provider-job checkpoint: a retried call with the same key resumes the existing reframe instead of paying for a duplicate.

Response

Successful Response

object required

Changes