| name | digital-avatar |
| version | 1.0.0 |
| description | 数字人/虚拟形象生成和口播视频制作。支持多个后端：可灵 Kling、即梦 Jimeng、HeyGen、D-ID、Synthesia。输入形象描述或真人照片，输出数字人资源ID或口播视频片段。触发词：数字人、虚拟人、AI主播、avatar、口播视频、talking head。 |
数字人生成
功能
- 创建数字人形象：从描述或照片生成数字人
- 声纹克隆（可选）：上传音频样本 → 克隆声纹
- 生成口播视频：数字人 + 台词/音频 → 口播视频片段
语音来源选项
| 方式 | 说明 | 推荐场景 |
|---|
| 平台内置 TTS | 用平台预设声音 | 快速测试 |
| 上传音频 | 提供录好的音频文件 | 有现成配音 |
| 平台声纹克隆 | 上传样本 → 平台克隆 | 推荐，全链路统一 |
| 外部 TTS | 用 MiniMax 等生成后上传 | 平台不支持克隆时 |
推荐：优先用平台自带的声纹克隆，保持后端一致性。
⚠️ 重要：后端一致性原则
同一个数字人项目必须全程使用同一个后端！
- 可灵的 avatar_id 和即梦的不互通
- 即梦创建的形象，可灵用不了，反之亦然
- 选定后端后，从创建形象到生成口播都用同一个
支持的后端
| 后端 | 数字人 | 口播 | 声纹克隆 | 特点 |
|---|
| Kling 可灵 | ✓ | ✓ | ✓ | 质量高，国产首选 |
| Jimeng 即梦 | ✓ | ✓ | ✓ | 快，中文口型好，剪映生态 |
| HeyGen | ✓ | ✓ | ✓ | 模板丰富，出海/英文 |
| D-ID | ✓ | ✓ | - | 简单快速 |
| Synthesia | ✓ | ✓ | ✓ | 企业级，多语言 |
推荐：国内项目优先用可灵或即梦，二选一后全程使用。
工作流程
流程 A：创建数字人
输入: 形象描述 / 真人照片
↓
选择后端
↓
调用 API 生成
↓
输出: avatar_id + 预览图
流程 B：生成口播视频
输入: avatar_id + 台词文本/音频
↓
调用后端口播 API
↓
等待渲染
↓
输出: 视频文件 URL
输入参数
创建数字人
| 参数 | 必填 | 说明 |
|---|
| mode | ✓ | create |
| backend | - | kling / jimeng / heygen / d-id / synthesia |
| description | △ | 形象描述（二选一） |
| photo | △ | 真人照片路径（二选一） |
| style | - | realistic / cartoon / 3d |
| gender | - | male / female |
声纹克隆（可选）
| 参数 | 必填 | 说明 |
|---|
| mode | ✓ | voice_clone |
| backend | - | kling / jimeng（需支持） |
| audio_sample | ✓ | 音频样本（10s-3min） |
| name | - | 声纹名称 |
输出：voice_id，后续生成口播时使用。
生成口播视频
| 参数 | 必填 | 说明 |
|---|
| mode | ✓ | generate |
| backend | - | 同上 |
| avatar_id | ✓ | 数字人 ID |
| text | △ | 台词文本（三选一） |
| audio | △ | 音频文件路径（三选一） |
| voice_id | △ | 克隆声纹 ID + text（三选一） |
| emotion | - | neutral / happy / serious |
| speed | - | 语速 0.5-2.0（默认1.0） |
输出格式
创建数字人
avatar:
id: "avatar_abc123"
backend: jimeng
preview_url: "https://..."
style: realistic
created_at: "2024-01-01T00:00:00Z"
生成口播视频
video:
id: "video_xyz789"
avatar_id: "avatar_abc123"
url: "https://..."
duration: 15.5
status: completed
后端配置
在 openclaw.json 中配置（只需配置你选用的后端）：
Kling 可灵（推荐）
{
"kling": {
"access_key": "your_access_key",
"secret_key": "your_secret_key"
}
}
Jimeng 即梦
{
"jimeng": {
"api_key": "ak-xxxxxxxx"
}
}
HeyGen
{
"heygen": {
"api_key": "xxx"
}
}
详见 references/backend-setup.md
使用示例
从描述创建
用户：帮我创建一个数字人，25岁左右的职业女性，干练短发
执行：
1. mode=create, description="25岁职业女性，干练短发", style=realistic
2. 调用 Jimeng API
3. 返回 avatar_id
从照片创建
用户：用这张照片创建数字人 [附图]
执行：
1. mode=create, photo=<图片路径>
2. 调用 API 上传照片
3. 返回 avatar_id
生成口播
用户：用 avatar_abc123 说这段话："大家好，今天教大家..."
执行：
1. mode=generate, avatar_id="avatar_abc123", text="大家好..."
2. 调用口播 API
3. 等待渲染完成
4. 返回视频 URL
与上下游对接
上游：video-script-generator 输出的 narration 字段
下游：scene-video-generator / video-stitcher 消费口播视频
注意事项
- 真人照片需获得授权
- 商用需确认后端的版权协议
- 口播视频渲染可能需要 1-5 分钟
- 建议缓存 avatar_id 避免重复创建
