Sign inGet started
falText to videoComing soon

mirage-api/avatar-x/text-to-video

mirage-api/avatar-x/text-to-video is a text to video tool from fal that runs in the background and returns video. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Price pending

Pricing

Price pending.

Limits

Runs
In the background
Returns
video
Longest queue wait
3600s
Run deadline
3600s
Largest inline input
1024 KB
Largest input file
500 MB
Largest output
4768 MB
Outputs per run
16

Input

FieldKindDefaultDescription
script requiredtext—Use 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.
avatarone of
None, Ayesha, Ayesha (16:9), Farhan, Farhan (16:9), Giulia, Giulia (16:9), Jasmine, Jasmine (16:9), Luke, Luke (16:9), Maya, Maya (16:9), Michael, Michael (16:9), Neha, Neha (16:9), Tariq, Tariq (16:9), Valerie, Valerie (16:9)
JasmineStock 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.
video_reference_urltext—Publicly 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.
audio_reference_urltext—Publicly 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.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "mirage-api/avatar-x/text-to-video",
    "input": {
      "script": "Put in a script, and Mirage Avatar X turns it into a clear, expressive video. Let’s bring your next idea to life."
    }
  }'