{"version":"1","model":{"id":"fal-ai/heygen/avatar5/digital-twin","name":"HeyGen Avatar V Digital Twin","kind":"video","availability":"available","available":true,"restricted":false,"api_key_only":false,"description":"HeyGen Avatar V Digital Twin — studio-quality talking-avatar video from your Digital Twin, driven by a script + voice. Routed directly to HeyGen's v3 API with the Avatar V engine.","pricing_note":"Estimated from script length (~15 chars/sec of speech); actual output may vary.","categories":["lipsync"],"prompt_required":true,"prompt_supported":true,"supports":{},"requires":{},"aspect_ratios":["16:9","9:16","4:5","5:4","1:1"],"resolutions":["720p","1080p","4k"],"durations":[],"base_credits":42,"api_gross_margin_percent":20,"added_at":"2026-05-20","popularity_rank":385,"example_prompt":"Hi there! I'm here to introduce our new product line — let me walk you through the key features.","preview":{"video":"https://cdn.artemotion.ai/file/artemotion-ai-bckt/model-previews/heygen-avatar-v-digital-twin-fal-v1-sm.mp4"},"schema_url":"/api/v1/models?id=fal-ai%2Fheygen%2Favatar5%2Fdigital-twin","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fheygen%2Favatar5%2Fdigital-twin","title":"HeyGen Avatar V Digital Twin generation request","description":"Request body accepted by POST /api/v1/generate for fal-ai/heygen/avatar5/digital-twin.","type":"object","properties":{"model_id":{"type":"string","const":"fal-ai/heygen/avatar5/digital-twin","description":"ArtEmotion model identifier."},"extra":{"type":"object","additionalProperties":true,"description":"Model-specific settings may also be nested here."},"max_credits":{"type":"number","minimum":1,"description":"Reject before submission if the estimated list price exceeds this cap."},"webhook_url":{"type":"string","format":"uri","maxLength":2048},"webhook_secret":{"type":"string","maxLength":512},"folder_id":{"type":"string"},"prompt":{"type":"string"},"avatar_id":{"title":"Digital Twin ID","description":"Your HeyGen Digital Twin look id — GET /v3/avatars/looks?avatar_type=digital_twin. Required.","default":"","type":"string"},"voice_id":{"title":"Voice ID","description":"Your HeyGen voice_id (GET /v2/voices) — the voice the twin speaks your script in. Required.","default":"","type":"string"},"voice_speed":{"title":"Voice Speed","description":"Speech speed multiplier (0.5–1.5).","default":1,"type":"number","minimum":0.5,"maximum":1.5,"multipleOf":0.05},"voice_pitch":{"title":"Voice Pitch","description":"Voice pitch adjustment (-50 to 50).","default":0,"type":"number","minimum":-50,"maximum":50,"multipleOf":1},"voice_volume":{"title":"Voice Volume","description":"Voice audio volume. 1.0 = full, 0.0 = silent — useful when mixing with background audio.","default":1,"type":"number","minimum":0,"maximum":1,"multipleOf":0.05},"remove_background":{"title":"Remove Background","description":"Render with a removed/transparent background (overrides the Background setting).","default":false,"type":"boolean"},"fit":{"title":"Fit","description":"How the avatar is fitted to the output canvas. Auto picks based on source/canvas orientation.","default":"","type":"string","enum":["","cover","contain"]},"locale":{"title":"Locale","description":"Optional BCP-47 locale for multilingual delivery (e.g. en-US, es-ES). Leave empty to auto-detect.","default":"","type":"string"},"bg_type":{"title":"Background Type","description":"Background behind the avatar (ignored when Remove Background is on).","default":"color","type":"string","enum":["color","image"]},"bg_value":{"title":"Background","description":"Hex color (e.g. #1144FF) for 'color', or HTTP(S) image URL for 'image'.","default":"","type":"string"},"output_format":{"title":"Output Format","description":"Video output format.","default":"mp4","type":"string","enum":["mp4","webm"]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:5","5:4","1:1"]},"resolution":{"type":"string","enum":["720p","1080p","4k"]}},"required":["model_id","prompt","avatar_id","voice_id"],"additionalProperties":false},"parameters":[{"key":"avatar_id","label":"Digital Twin ID","type":"text","default":"","required":true,"description":"Your HeyGen Digital Twin look id — GET /v3/avatars/looks?avatar_type=digital_twin. Required."},{"key":"voice_id","label":"Voice ID","type":"text","default":"","required":true,"description":"Your HeyGen voice_id (GET /v2/voices) — the voice the twin speaks your script in. Required."},{"key":"voice_speed","label":"Voice Speed","type":"number","default":1,"min":0.5,"max":1.5,"step":0.05,"description":"Speech speed multiplier (0.5–1.5)."},{"key":"voice_pitch","label":"Voice Pitch","type":"number","default":0,"min":-50,"max":50,"step":1,"description":"Voice pitch adjustment (-50 to 50)."},{"key":"voice_volume","label":"Voice Volume","type":"number","default":1,"min":0,"max":1,"step":0.05,"description":"Voice audio volume. 1.0 = full, 0.0 = silent — useful when mixing with background audio."},{"key":"remove_background","label":"Remove Background","type":"toggle","default":false,"description":"Render with a removed/transparent background (overrides the Background setting)."},{"key":"fit","label":"Fit","type":"select","default":"","options":["","cover","contain"],"description":"How the avatar is fitted to the output canvas. Auto picks based on source/canvas orientation."},{"key":"locale","label":"Locale","type":"text","default":"","description":"Optional BCP-47 locale for multilingual delivery (e.g. en-US, es-ES). Leave empty to auto-detect."},{"key":"bg_type","label":"Background Type","type":"select","default":"color","options":["color","image"],"description":"Background behind the avatar (ignored when Remove Background is on)."},{"key":"bg_value","label":"Background","type":"text","default":"","description":"Hex color (e.g. #1144FF) for 'color', or HTTP(S) image URL for 'image'."},{"key":"output_format","label":"Output Format","type":"select","default":"mp4","options":["mp4","webm"],"description":"Video output format."}]}}