HeyGen Video Agent

{
  "model_id": "fal-ai/heygen/v3/video-agent",
  "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"
}

{
  "$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
}