GET

/v1/schemas/fal/video/bytedance/omnihuman/v2

kind inputactivity videohash 1af523a5…extracted Oct 16, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
3c9a0cfda8b006743f0aad634c2da728e5febaa9fe59363dfac19a3156168d96
{
  "fetchedAt": 1792126843,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

3 properties · 2 required · 0 $defs
propertytypedescriptionconstraints
image_url*stringThe URL of the image used to generate the video. Format: jpeg, png, webp, bmp, tiff, gif, heic or heif. Max size: 30 MB. Aspect ratio (width/height) between 0.4 and 2.5; width and height between 300 and 6000 pixels.
audio_url*stringThe URL of the audio file to generate the video. Format: wav or mp3. Max size: 15 MB. Duration between 4 and 300 seconds.
promptstringOptional text prompt for precise control of the scene, movements and camera. Supported languages: Chinese, English, Japanese, Korean, Spanish (Mexican) and Indonesian.nullable

Validate a payload

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