SuperAPI AI 工具集

heygen-digital-avatar

设计与创作

查看项目

更新于 10-15 21:34

技能介绍

该技能用于在内容工作区中创建和合成 HeyGen 数字人视频,适用于用户提出数字人、数字人5、HeyGen、AI 口播人物、数字人小窗、圆形头像口播等需求时。

用途与分工:本技能只负责 HeyGen 鉴权、头像选择、生成和已批准的头像版式;整体制作、字幕、质检和归档由 ra-video-production-director 负责。编写或批准任何 HeyGen motion_prompt 前,必须先加载并应用 heygen-avatar-motion,其动作分类与校验门为强制要求,校验不通过时不得提交付费生成。

主要能力与规则:构建前读取 references/pluviobyte-profile.json 作为机器可读默认配置,不得换成同组其他形象。使用 HeyGen CLI OAuth 鉴权与 Creator 订阅额度,命令运行时从子环境移除 HEYGEN_API_KEY。默认使用横版 Digital Twin 形象;未指定时用 Avatar III;名为“数字人5”的预设始终指 Avatar V,属显式高级引擎请求,不得解析为 Avatar III。语音使用本地 IndexTTS2 与 voice pluvio-indextts2-calm-v1,不让 HeyGen 合成语音,也不用 MiniMax 等回退。

用法与门槛:旁白批准是付费生成的硬门槛——先完整生成 IndexTTS2 试听并交给用户,等待明确确认并记录 WAV 的 SHA-256,上传前重新计算校验,不一致则作废批准。默认采用已批准的 headroom_08 左下圆形头像(240px、单条白边、无彩色外环),仅当用户明确说全屏数字人才用全屏。合成器需采样五帧、用 macOS Vision 测量人脸中心并应用已审核视觉偏移,渲染后平均人脸中心需落在偏移目标 2px 内。先用 env -u HEYGEN_API_KEY heygen auth status 检查凭证类型 oauth、计费 subscription、套餐 creator,不符则停止。上传用 env -u HEYGEN_API_KEY heygen asset create --file <narration.wav>;用 python3 scripts/build_request.py 构建请求,再以 env -u HEYGEN_API_KEY heygen video create -d ... --wait 生成;合成用 python3 scripts/compose_circle_avatar.py。默认只生成一个 HeyGen 母版,版式试验须本地重组、不再消耗额度;Avatar IV/V 仅在用户要求更高质量、调用“数字人5”或 Avatar III 未通过审核后使用,并先说明额度/成本增加。

限制:官方文档未提供具体价格、平台覆盖与效果保证;OAuth token 与 API 密钥不得写入项目产物。