用途：通过 ibl.ai 的专用视频接口驱动 HeyGen，完成声音、头像、视频与交互式会话的生成和管理。数据管理器转发到 HeyGen 并原样返回其响应体，因此响应内层结构以 HeyGen 文档为准，ibl.ai 只在外层加上鉴权、积分、归属等封装。
主要能力：声音方面可列出、克隆声音并合成语音；头像方面可创建照片或数字分身头像组、轮询训练状态、列出外观、生成授权链接；视频方面可生成并轮询至完成；素材方面可上传媒体供上述接口引用；流式方面可创建交互会话并驱动实时说话头像。
使用方式：基础地址为 https://api.iblai.app/dm/api/ai-agent/orgs/{org}/users/{username}/providers/heygen/video，每个请求带 Authorization: Api-Token $IBLAI_API_KEY。{org} 为组织键，{username} 通常须为本人，组织管理员可操作任意成员路径。接口的实时 OpenAPI schema 是唯一契约，构建请求前应校验：https://api.iblai.app/dm/api/docs/schema/。未声明的字段会被转发给 HeyGen。
适用场景：已登录成员为自己生成声音、头像、视频或直播会话；管理员通过通用代理处理本接口未暴露的动作。
限制：视频生成、声音克隆训练、数字分身训练均为异步且无回调，需轮询详情接口，建议间隔 5 秒。计费端点包括声音克隆、语音合成、创建头像组、生成视频、创建流式会话；仅当由 ibl.ai 提供 HeyGen 账号时才扣积分，余额不足返回 402，失败调用不计费。读取、控制、授权与素材上传免费。归属门禁：操作他人拥有的 id 返回 403；无归属记录的 id 会被放行。上游鉴权失败返回 502，HeyGen 的 503 归一化为 429。streaming/knowledge-bases/ 是唯一被扁平化处理的响应。交互会话时长不会通过本接口回传，结束后应主动发送 stop。