用途：当制作路径确定为 HeyGen，且交付物涉及 AI 主持人、数字分身、照片数字人、工作室数字人或实时流式数字人时使用。该技能把 HeyGen 同时视为视频创作工具与肖像处理系统，生成前需先锁定同意授权、身份权利、脚本意图、声音权利和产物保管。
主要能力与路由：Video Agent（POST /v3/video-agents）适合用自然语言简述生成完整数字人视频，速度快但场景控制弱；Direct Video（POST /v3/videos，type: "avatar"）适合脚本、形象、声音、画幅、背景、字幕、水印、输出格式或动作提示需明确可复现的生产管线；Cinematic Avatar（type: "cinematic_avatar"）仅用于 1-3 个形象、无口播的短片；Avatar Realtime（POST /v3/avatar-realtime）用于实时 HLS 流，适合自助终端、实时助手与直播，不是渲染 MP4；视频翻译与唇形同步 API 用于保留原始画面时的后期本地化。
必要用法：确认鉴权与计费路径（Direct API 用 X-Api-Key 计 API 钱包，OAuth 的 MCP/Agent 可能计网页套餐余额）；用 GET /v3/avatars/looks 查询形象并传 look ID 作为 avatar_id；用 GET /v3/voices 查询声音；数字分身须完成同意流程，可用 POST /v3/avatars/{group_id}/consent；确认资源限制与文件公开可达性；设置回调、轮询节奏、失败处理与下载保管策略；渲染前定义 QA 标准。Direct Video 中 Avatar IV 为省略 engine 时的默认引擎，Avatar V 保真度更高但支持更窄且文档标注为数字分身专属，motion_prompt 与 expressiveness 有形象与引擎限制，使用前应用 GET /v3/avatars/looks/{look_id} 检查 supported_api_engines。
适用场景与限制：适合品牌口播、个性化营销、合规审核脚本的企业培训视频及实时数字人交互。生成是异步的，状态含 pending、processing、completed、failed；失败需区分 401、429、资源不可达、参数校验和审核拒绝，权利/同意失败与审核拒绝不应原样重试。价格、引擎支持、端点结构、限制、状态值、审核政策与套餐权益等易变字段需在付费运行前重新核对官方文档。禁止未经授权克隆或冒充真人，受众可能误解时应添加 AI 生成主持人声明。资料未提供具体价格、完整上传格式清单及部分平台细节。