GET

/v1/schemas/fal/video/fal-ai/bytedance/dreamactor/v2

Accept:

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

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

Request body

4 properties · 2 required · 0 $defs

property	type	description	constraints
video_url*	string	The URL of the driving template video providing motion, facial expressions, and lip movement reference. Max duration: 30 seconds. Format: mp4, mov or webm. Resolution: between 200x200 and 2048x1440. Supports full face and body driving.
image_url*	string	The URL of the reference image to animate. Supports real people, animation, pets, etc. Format: jpeg, jpg or png. Max size: 4.7 MB. Resolution: between 480x480 and 1920x1080 (larger images will be proportionally reduced).
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true
trim_first_second	boolean	Whether to crop the first second of the output video. The output has a 1-second transition at the beginning; enable this to remove it.	default: true

Validate a payload

before you spend tokens

shell

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