{"version":"1","model":{"id":"fal-ai/heygen/v3/video-agent","name":"HeyGen Video Agent","kind":"video","availability":"available","available":true,"restricted":false,"api_key_only":false,"description":"HeyGen Video Agent generates cinematic talking-head videos from a portrait image and an audio clip or text prompt, with realistic facial motion and atmosphere.","pricing_note":"Estimated from script length (~15 chars/sec of speech); actual output may vary.","categories":["lipsync"],"prompt_required":true,"prompt_supported":true,"supports":{"fileUrls":true},"requires":{},"aspect_ratios":[],"resolutions":[],"durations":[],"base_credits":22,"api_gross_margin_percent":20,"added_at":"2026-05-06","popularity_rank":384,"example_prompt":"Battle-worn firefighter looking into the distance after a dangerous mission, subtle emotional expression, realistic breathing, cinematic rain, flashing red and blue emergency lights, handheld camera feel, dramatic atmosphere, ultra realistic facial motion","preview":{"video":"https://cdn.artemotion.ai/file/artemotion-ai-bckt/model-previews/heygen-v3-video-agent-sm.mp4"},"schema_url":"/api/v1/models?id=fal-ai%2Fheygen%2Fv3%2Fvideo-agent","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fheygen%2Fv3%2Fvideo-agent","title":"HeyGen Video Agent generation request","description":"Request body accepted by POST /api/v1/generate for fal-ai/heygen/v3/video-agent.","type":"object","properties":{"model_id":{"type":"string","const":"fal-ai/heygen/v3/video-agent","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":{"title":"Avatar","description":"HeyGen avatar id, or 'auto' to let HeyGen choose.","default":"auto","type":"string"},"voice":{"title":"Voice","description":"HeyGen voice id, or 'auto' to let HeyGen choose.","default":"auto","type":"string"},"orientation":{"title":"Orientation","description":"Output orientation. Leave on Auto to let HeyGen decide.","default":"","type":"string","enum":["","landscape","portrait"]},"style_id":{"title":"Style ID","description":"Optional HeyGen style id to apply a visual template.","default":"","type":"string"},"incognito_mode":{"title":"Incognito Mode","description":"Don't save this generation to your HeyGen project history.","default":false,"type":"boolean"}},"required":["model_id","prompt"],"additionalProperties":false},"parameters":[{"key":"avatar","label":"Avatar","type":"text","default":"auto","description":"HeyGen avatar id, or 'auto' to let HeyGen choose."},{"key":"voice","label":"Voice","type":"text","default":"auto","description":"HeyGen voice id, or 'auto' to let HeyGen choose."},{"key":"orientation","label":"Orientation","type":"select","default":"","options":["","landscape","portrait"],"description":"Output orientation. Leave on Auto to let HeyGen decide."},{"key":"style_id","label":"Style ID","type":"text","default":"","description":"Optional HeyGen style id to apply a visual template."},{"key":"incognito_mode","label":"Incognito Mode","type":"toggle","default":false,"description":"Don't save this generation to your HeyGen project history."}]}}