GET

/v1/schemas/fal/video/mirage-api/avatar-x/text-to-video

kind inputactivity videohash 6e35d502…extracted Aug 15, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
717921e7cf1acf932ac2a63d17b478fb7bb6a822fdc55cc7d8d761c565aa8846
{
  "fetchedAt": 1786770058,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

4 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
script*stringUse 50 to 1,500 characters. The 50-character minimum typically produces about four seconds of speech. Generated speech must be 180 seconds or shorter; speaking pace may cause shorter scripts to exceed this limit.length ≥ 50 · length ≤ 1500
video_reference_urlstringPublicly fetchable HTTPS URL of a reference video. When supplied, audio_reference_url is also required and the selected avatar is ignored; no cookies or authorization headers. Supports H.264, H.265/HEVC, or ProRes in .mp4, .mov, or .m4v and VP8 or VP9 in .webm, from 1 to 120 seconds and up to 1 GiB, with a 9:16 or 16:9 display aspect ratio (within 5%). Any audio track is ignored.nullable
avatarenumStock visual and voice. Browse the [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) to preview every available avatar and copy the exact Avatar value. Select None to send no avatar. When video_reference_url and audio_reference_url are both supplied, the references replace the avatar entirely and it may be omitted.None | Ayesha | Ayesha (16:9) | Farhan | Farhan (16:9) | Giulia · +15 more · nullable
audio_reference_urlstringPublicly fetchable HTTPS URL of a voice reference. When supplied, video_reference_url is also required and the selected avatar is ignored; no cookies or authorization headers. Supports MP3, PCM WAV or AIFF, AAC or ALAC, Opus or Vorbis, and FLAC audio from 10 to 180 seconds and up to 64 MiB, with one mono or stereo stream sampled from 8 to 48 kHz. Only the first 60 seconds are used.nullable

Validate a payload

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