GET

/v1/schemas/fal/video/fal-ai%2Fbytedance%2Fdreamactor%2Fv2

kind inputactivity videohash d078ce9aextracted Jul 6, 2026version currentsource upstream spec ↗

Request body

3 properties · 2 required · 0 $defs
propertytypedescriptionconstraints
video_url*stringThe 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*stringThe 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).
trim_first_secondbooleanWhether 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", …}]}