HeyGen Voice

Name: HeyGen Voice
Price: 0.03 USD
Availability: InStock
Author: HeyGen

heygen/heygen-voice

HeyGen Voice turns text into natural speech in 39 languages, with 24 public voices or a cloned voice from a reference recording.

Use in agent Get API key

Base price: $0.03USD / run
Execution: async
Model type: audio
Input fields: 4

Production route

Try the model

Playground

Open playground

Input

Text(string)

Text to speak, up to 5,000 characters.

Voice(string)

HeyGen public voice. Ignored when reference_audio is set. Allowed values: Jonah, Nadine, Tabitha, Soren, Elowen, Vincent, Jocelyn, Marielle, Corinne, Lucian, Kieran, Hugh, Noelle, Bram, Ewan, Iona, Cecily, Simon, Weston, Felicity, Gareth, Rory, Meredith, Sabrina.

Language(string)

Language of the text. Detected automatically when omitted. Allowed values: 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.

Reference Audio(string)

Optional single-speaker recording to clone instead of a public voice. Only the first 3 minutes are used.

OutputExample

Open original

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price: $0.03 / run

Context & modalities

Input: Schema-defined
Output: audio

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: HeyGen
Model ID: heygen/heygen-voice
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

HeyGen Voice

HeyGen Voice turns text into natural speech in 39 languages, using one of 24 public voices or a voice cloned from a reference recording.

Fields

Field	Type	Default	Notes
`text`	string, required	—	Up to 5,000 characters.
`voice`	24 public voices	`Jonah`	Ignored when `reference_audio` is set.
`language`	ISO 639-1 code (39 languages)	auto	Language of the text.
`reference_audio`	audio URL	—	Single-speaker recording to clone; the first 3 minutes are used.

Billing

$0.03 per started 1,000 characters of input text.

Text	Price
Up to 1,000 characters	$0.03
2,500 characters	$0.09
5,000 characters	$0.15
Failed runs are not charged.

Limits

Up to 5,000 characters per request.

Also on SandBase

Faster, lower-cost tier: heygen/heygen-voice/turbo.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

heygen/heygen-voice

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "heygen/heygen-voice",
  "text": "Hello! This is HeyGen Voice, speaking on fal.",
  "voice": "Jonah"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models

Model	Type	Default price	Released
HeyGen VoiceThis model `HeyGen`	Audio	$0.03 / run	Oct 21, 2026
HeyGen Voice Turbo `HeyGen`	Audio	$0.00 / run	Oct 21, 2026

Questions

FAQ

How do I call HeyGen Voice through SandBase?

Create a SandBase API key, then send requests with the model ID "heygen/heygen-voice" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate HeyGen account?

No. One SandBase API key and balance gives you access to HeyGen Voice and the other models in the catalog; you do not need to sign up with HeyGen separately.