Spiral gives your agent every tool with one account. Browse the tools →

falAudioAvailable nowReleased 2026-10-20

HeyGen Voice

heygen/heygen-voice

Generate speech, music and audio with HeyGen Voice from fal through one Spiral API key. HeyGen Voice turns text into natural speech with a library voice or an instant clone from a reference clip. It runs in the background and returns audio. Pay as you go, with no subscription.

Pricing

$0.039 per 1,000 characters of text.

Limits

Runs
In the background
Returns
audio
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
255 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
text requiredtext—

The text to speak.

voiceone of
Jonah, Nadine, Tabitha, Soren, Elowen, Vincent, Jocelyn, Marielle, Corinne, Lucian, Kieran, Hugh, Noelle, Bram, Ewan, Iona, Cecily, Simon, Weston, Felicity, Gareth, Rory, Meredith, Sabrina
Jonah

HeyGen public voice. Ignored when reference_audio_url is set.

reference_audio_urltext—

Recording of a single speaker to clone instead of using a public voice. Only the first 3 minutes are used.

languageone of
ar, be, bg, ca, cs, da, de, el, en, es, fa, fi, fr, he, hi, hr, hu, id, it, ja, ko, mk, ms, nl, pl, pt, ro, ru, sk, sl, sr, sv, ta, th, tl, tr, uk, vi, zh
—

Language of the text. Detected from the text when omitted.

expressiveness_boostnumber
0 to 1
1

How expressive the delivery is.

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": "heygen/heygen-voice",
    "input": {
      "text": "Hello! This is HeyGen Voice, speaking on fal."
    }
  }'

Frequently asked questions

How much does HeyGen Voice cost?

$0.039 per 1,000 characters of `text`. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use HeyGen Voice through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "heygen/heygen-voice"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use HeyGen Voice?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use HeyGen Voice?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.