GET

/v1/schemas/fal/video/luma/agent/ray/v3.2/reframe

Accept:

kind inputactivity videohash b784c019…extracted Oct 9, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `4684a2912186ba296705ad1aeb917089944f3f373611ff314e804dc18b1e8e80` { "fetchedAt": 1791522002, "extractorVersion": "1", "verifiedAt": null }

Request body

7 properties · 3 required · 1 $defs

property	type	description	constraints
video_url*	string	URL of the source video to reframe (must be 10 seconds or less).	length ≥ 1
aspect_ratio*	enum	Target aspect ratio for the reframed video.	3:4 \| 4:3 \| 1:1 \| 9:16 \| 16:9 \| 21:9
prompt*	string	Text prompt describing the content to paint into the newly exposed canvas area when reframing to the target aspect ratio.	length ≥ 1 · length ≤ 6000
duration	enum	Duration of the reframed video. Defaults to matching the source video's duration; set explicitly to 5s or 10s to override.	5s \| 10s · nullable
source_position	RayReframeSourcePosition	Optional normalized source rectangle controlling where the source video sits in the output canvas.	nullable
resolution	enum	Resolution of the reframed video. Higher resolutions cost more.	540p \| 720p \| 1080p · default: "540p"
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true

Types

1 $defs

RayReframeSourcePositionobject

y_norm*	number	Top edge of the source rectangle as a fraction of output height.	-2 ≤ n ≤ 2
x_norm*	number	Left edge of the source rectangle as a fraction of output width.	-2 ≤ n ≤ 2
w_norm*	number	Width of the source rectangle as a fraction of output width.	0 < n ≤ 2
h_norm*	number	Height of the source rectangle as a fraction of output height.	0 < n ≤ 2

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"luma/agent/ray/v3.2/reframe","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}