Heygen v5 Digital Twin

curl -X POST https://superpowers.tools/v1/run \
  -H 'Authorization: Bearer $SP_KEY' \
  -d '{"tool":"fal.heygen-avatar5-digital-twin","input":{"fit":"cover"},"idempotency_key":"example-request-1"}'

{
  "type": "object",
  "required": [],
  "properties": {
    "fit": {
      "type": "string",
      "description": "How the avatar fits within the output frame. 'contain' keeps the full avatar in view (may letterbox); 'cover' fills the frame (may crop).",
      "default": "cover",
      "enum": [
        "contain",
        "cover"
      ]
    },
    "avatar": {
      "type": "string",
      "description": "Name of the Avatar V-eligible avatar to use.",
      "default": "Abigail Sofa Front"
    },
    "resolution": {
      "type": "string",
      "description": "Output resolution preset.",
      "default": "720p",
      "enum": [
        "720p",
        "1080p",
        "4k"
      ]
    },
    "voice": {
      "type": "string",
      "description": "Name of the text-to-speech voice to use for the avatar when ``audio_url`` is not provided.",
      "default": "Warm Pro Narrator",
      "enum": [
        "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"
      ]
    },
    "prompt": {
      "type": "string",
      "description": "Text the avatar will speak. Required when ``audio_url`` is not provided."
    },
    "audio_url": {
      "type": "string",
      "description": "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."
    },
    "output_format": {
      "type": "string",
      "description": "Output container format. 'webm' produces a transparent video (automatically removes the background) and ignores the ``background`` field.",
      "default": "mp4",
      "enum": [
        "mp4",
        "webm"
      ]
    },
    "background": {
      "type": "null",
      "description": "Optional background to composite behind the avatar. Ignored when ``output_format='webm'`` (webm output is transparent)."
    },
    "watermark": {
      "type": "null",
      "description": "Optional watermark image to overlay on the output video."
    },
    "caption": {
      "type": "boolean",
      "description": "Generate a sidecar SRT caption file alongside the video.",
      "default": false
    },
    "aspect_ratio": {
      "type": "string",
      "description": "Aspect ratio of the output video. Supported values: '16:9', '9:16', '4:5', '5:4', '1:1', and 'auto'. 'auto' preserves the source aspect ratio when HeyGen can read it, falling back to '16:9' otherwise.",
      "default": "16:9",
      "enum": [
        "16:9",
        "9:16",
        "4:5",
        "5:4",
        "1:1",
        "auto"
      ]
    },
    "remove_background": {
      "type": "boolean",
      "description": "Remove the avatar's background. Requires a matting-enabled avatar.",
      "default": false
    }
  }
}