GET

/v1/schemas/fal/video/heygen/heygen-video/reference-to-video

kind inputactivity videohash 05a09e65…extracted Nov 10, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
6ec7099907972f6780202873f14dc8b798b403d9049cfc7222c683c6879d340b
{
  "fetchedAt": 1794286801,
  "extractorVersion": "2",
  "verifiedAt": null
}

Request body

10 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
prompt*stringlength ≥ 1 · length ≤ 32000
resolutionenum480p | 768p | 1080p | 2k · default: "768p"
aspect_ratioenumadaptive | 21:9 | 16:9 | 4:3 | 1:1 | 3:4 · +1 more · default: "adaptive"
durationinteger5 ≤ n ≤ 15 · default: 5
reference_video_urlsstring[]items ≤ 3
reference_image_urlsstring[]items ≤ 9
seedinteger0 ≤ n ≤ 4294967295 · nullable
prompt_enhancementenumturbo | quality | ultraquality | disabled · default: "turbo"
reference_audio_urlsstring[]items ≤ 3
enable_safety_checkerbooleanAuthorized callers may set false to request relaxed screening.default: true

Validate a payload

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