用途：该技能封装 HeyGen API，用于通过 AI 数字人（avatar）与 AI 配音生成视频，并管理已生成视频。适合产品演示、口播视频、批量模板化视频制作及视频翻译等场景。
主要能力：列出与查询可用头像及详情；列出可用声音（含语言、性别、情绪支持等属性）；创建数字人视频；查询视频生成状态；列出与删除视频；列出与查询模板并从模板生成视频；翻译视频并查询支持的翻译语言；为视频生成分享链接。
必要用法：假设已设置 HEYGEN_TOKEN 环境变量，请求通过 x-api-key 头传递。v1 基础地址为 https://api.heygen.com/v1，v2 为 https://api.heygen.com/v2。典型流程是先调用 GET https://api.heygen.com/v2/avatars 与 GET https://api.heygen.com/v2/voices 获取 avatar_id 与 voice_id，再把请求体写入 /tmp/heygen_request.json，通过 POST https://api.heygen.com/v2/video/generate 生成，返回 video_id；随后轮询 GET https://api.heygen.com/v1/video_status.get?video_id=<video_id> 直到 completed 或 failed。复杂请求体建议写入 JSON 文件避免 shell 引号问题。
连接排查：请求失败时可运行 zero doctor check-connector --env-name HEYGEN_TOKEN 或 zero doctor check-connector --url https://api.heygen.com/v2/avatars --method GET。
限制与注意事项：生成是异步的，需轮询状态；视频与缩略图 URL 7 天后过期，应及时下载；生成会按视频时长消耗 API 积分；模板需先在 HeyGen 后台创建；头像与声音需从账号可用列表中选取。资料未提供官方定价、额度与具体错误码等细节。