GET

/v1/schemas/fal/video/fal-ai/pixverse/swap

Accept:

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

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

Request body

8 properties · 2 required · 0 $defs

property	type	description	constraints
video_url*	string	URL of the external video to swap
image_url*	string	URL of the target image for swapping
original_sound_switch	boolean	Whether to keep the original audio	default: true
keyframe_id	integer	The keyframe ID to use for face/object mapping. The input video is normalized to 24 FPS before processing, so keyframe 1 = first frame, keyframe 24 = 1 second in, etc. Valid range: 1 to (duration_seconds * 24).	n ≥ 1 · default: 1
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true
resolution	enum	The output resolution (1080p not supported)	360p \| 540p \| 720p · default: "720p"
seed	integer	Random seed for generation	nullable
mode	enum	The swap mode to use	person \| object \| background · default: "person"

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/pixverse/swap","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}