HeyGen Avatar 5 Digital Twin

Name: HeyGen Avatar 5 Digital Twin
Price: 0.6 USD
Availability: InStock
Author: HeyGen

heygen/avatar5/digital-twin

Avatar5 Digital Twin by HeyGen - generate cinematic videos from text descriptions with AI. Create high-quality video content with natural motion, camera control, and optional audio generation.

Use in agent Get API key

Base price: $0.60USD / run
Execution: async
Model type: video
Input fields: 11

Production route

Try the model

Playground

Open playground

Input

Prompt(string)

Text the avatar will speak. Required when ``audio_url`` is not provided.

Aspect Ratio(string)

Output aspect ratio. Omit to keep the source aspect ratio (falls back to 16:9 when it cannot be read). Allowed values: 16:9, 9:16, 5:4, 4:5, 1:1.

Audio Url(string)

HTTP(S) URL of an audio file for the avatar to lip-sync to. When provided, the avatar uses this audio instead of text-to-speech and ``prompt``/``voice`` are ignored.

Resolution(string)

Output resolution preset. Allowed values: 720p, 1080p, 4k.

Output Format(string)

Output container format. 'webm' produces a transparent video (automatically removes the background) and ignores the ``background`` field. Allowed values: mp4, webm.

Remove Background(boolean)

Remove the avatar's background. Requires a matting-enabled avatar.

Avatar(string)

Name of the Avatar V-eligible avatar to use.

Voice(string)

Name of the text-to-speech voice to use for the avatar when ``audio_url`` is not provided. Allowed values: Warm Pro Narrator, Chill Brian, Ivy, John Doe, Monika Sogam, Hope , Archer , Brittney, Patrick, David Castlemore, Michael C, Adam Stone , Juniper, Cassidy , Jessica Anne Bogart, Arabella, Andrew, Spuds Oxley , Grace Elder, Helen, Canyon Rivers, Derya - Lifelike - Excited 🤩, Mellow Marcus, Jack Sterling - Broadcaster 🎙️, Brenda - UGC - 1.mp4, Reid, Reagan, Terry, Jenny, Radio Rick, Denise, Tim in car - Excited 🤩, Iskander, Thompson, Delicate Daisy - Excited 🤩, Kingston, George UGC 1, Bold Blake, Jane, Expressive Evan, Marianne - IA, Aaron, Modern Recipe Host - Voice 1, Willow, Cute Chloe - Friendly 😊, Rafael, June - Lifelike, Crisp Chloe, Slick Simon, Nassim - Informative, Baritone Ben, Maxwell, Ellie Faye - Excited 🤩, Milani, Feisty Fiona - Excited 🤩, Professor Dean, Rose - UGC - 1.mp4, Shona, Hudson Wilder, Ann - IA, Alastair Kensington, Oxley, Christina, Andrew Rizz , Peyton, Gerardo - Outdoor, Chloe - Lifelike, Stephanie, Anthony - IA, Signal - Voice 1, Luca, Lisa - Voice 1, T.W.Tucker, Jack Sullivan - Serious 😐, Winter, Mireia - Lifelike, Georgia, Stella, Masha - Lifelike, Charming Charles - Friendly 😊, Serenity, Annie - Excited, Ralph, Bethany, Dominic, Mason Finn, Leena, Veteran Victor, Tamara, Nik Public, Calm Chloe, Sevik, Reilly, Raul, Imposing Ian, Relaxed Ray, Dexter - Professional, Relaxed Rick, Edwin, Rupert Blackwood, Ginny, Hope.

Caption(boolean)

Generate a sidecar SRT caption file alongside the video.

Watermark(string)

Optional watermark image URL to overlay on the output video.

Fit(string)

How the avatar fits within the output frame. 'contain' keeps the full avatar in view (may letterbox); 'cover' fills the frame (may crop). Allowed values: contain, cover.

OutputExample

Open original

Examples

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

Model card

Specifications

Pricing

Base price: $0.60 / run

Context & modalities

Input: Schema-defined
Output: video

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/avatar5/digital-twin
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

HeyGen Avatar 5 Digital Twin

HeyGen Avatar 5 Digital Twin: a presenter video from a script or audio track, using a stock or custom avatar, up to 4K, with optional captions and background removal.

Fields

Field	Type	Default	Notes
`prompt`	string, required	—	Script to speak, or direction when `audio` is supplied.
`aspect_ratio`	`16:9` / `9:16` / `5:4` / `4:5` / `1:1`	—	Output frame shape.
`audio`	audio URL	—	Optional voice track; otherwise the script is voiced with `voice`.
`resolution`	`720p` / `1080p` / `4k`	`720p`	Output resolution.
`output_format`	`mp4` / `webm`	`mp4`	Output file format.
`remove_background`	boolean	false	Transparent background (WebM).
`avatar`	string	`Abigail Sofa Front`	Avatar to use.
`voice`	`Warm Pro Narrator` / `Chill Brian` / `Ivy` / `John Doe` / `Monika Sogam` / `Hope` / `Archer` / `Brittney` / `Patrick` / `David Castlemore` / `Michael C` / `Adam Stone` / `Juniper` / `Cassidy` / `Jessica Anne Bogart` / `Arabella` / `Andrew` / `Spuds Oxley` / `Grace Elder` / `Helen` / `Canyon Rivers` / `Derya - Lifelike - Excited 🤩` / `Mellow Marcus` / `Jack Sterling - Broadcaster 🎙️` / `Brenda - UGC - 1.mp4` / `Reid` / `Reagan` / `Terry` / `Jenny` / `Radio Rick` / `Denise` / `Tim in car - Excited 🤩` / `Iskander` / `Thompson` / `Delicate Daisy - Excited 🤩` / `Kingston` / `George UGC 1` / `Bold Blake` / `Jane` / `Expressive Evan` / `Marianne - IA` / `Aaron` / `Modern Recipe Host - Voice 1` / `Willow` / `Cute Chloe - Friendly 😊` / `Rafael` / `June - Lifelike` / `Crisp Chloe` / `Slick Simon` / `Nassim - Informative` / `Baritone Ben` / `Maxwell` / `Ellie Faye - Excited 🤩` / `Milani` / `Feisty Fiona - Excited 🤩` / `Professor Dean` / `Rose - UGC - 1.mp4` / `Shona` / `Hudson Wilder` / `Ann - IA` / `Alastair Kensington` / `Oxley` / `Christina` / `Andrew Rizz` / `Peyton` / `Gerardo - Outdoor` / `Chloe - Lifelike` / `Stephanie` / `Anthony - IA` / `Signal - Voice 1` / `Luca` / `Lisa - Voice 1` / `T.W.Tucker` / `Jack Sullivan - Serious 😐` / `Winter` / `Mireia - Lifelike` / `Georgia` / `Stella` / `Masha - Lifelike` / `Charming Charles - Friendly 😊` / `Serenity` / `Annie - Excited` / `Ralph` / `Bethany` / `Dominic` / `Mason Finn` / `Leena` / `Veteran Victor` / `Tamara` / `Nik Public` / `Calm Chloe` / `Sevik` / `Reilly` / `Raul` / `Imposing Ian` / `Relaxed Ray` / `Dexter - Professional` / `Relaxed Rick` / `Edwin` / `Rupert Blackwood` / `Ginny` / `Hope`	`Warm Pro Narrator`	Voice for the script.
`caption`	boolean	false	Burn in captions.
`watermark`	string	—	Optional watermark image URL to overlay on the output video.
`fit`	`contain` / `cover`	`cover`	How the avatar fills the frame.

Billing

$0.12 per output second; length follows the audio or the spoken script. The quote before submission assumes 5 seconds.

Output	Price
5s	$0.60
30s	$3.60
60s	$7.20

Failed runs are not charged.

Also on SandBase

Related: heygen/heygen-avatar4/image-to-video (from your own photo).

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/avatar5/digital-twin

# 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/avatar5/digital-twin",
  "fit": "cover",
  "voice": "Warm Pro Narrator",
  "avatar": "Abigail Office Front",
  "prompt": "Hello and welcome to this demonstration of HeyGen Avatar V.",
  "caption": false,
  "resolution": "720p",
  "output_format": "mp4",
  "remove_background": false
}
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 Avatar 5 Digital TwinThis model `HeyGen`	Video	$0.60 / run	May 20, 2026
HeyGen Video Text to Video `HeyGen`	Video	$0.18 / run	Oct 21, 2026
HeyGen Video Image to Video `HeyGen`	Video	$0.18 / run	Oct 21, 2026
HeyGen Video Reference to Video `HeyGen`	Video	$0.50 / run	Oct 21, 2026
HeyGen Video Agent V3 `HeyGen`	Video	$1.02 / run	Apr 16, 2026
HeyGen Lipsync Precision `HeyGen`	Video	$0.50 / run	Apr 16, 2026

Questions

FAQ

How do I call HeyGen Avatar 5 Digital Twin through SandBase?

Create a SandBase API key, then send requests with the model ID "heygen/avatar5/digital-twin" 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 Avatar 5 Digital Twin and the other models in the catalog; you do not need to sign up with HeyGen separately.