jiuma-free-meta-human（九马自由元人类）

jiuma-free-meta-human Skill

这是一个免费的数字人视频生成工具，基于九马（Jiuma）平台。输入文本内容或音频内容、数字人ID或数字人形象URL和音色ID，即可自动生成口型同步的数字人视频，生成时间通常在30分钟以内

功能特性

• 📝 文本转视频：输入文字内容，自动生成数字人视频
• 👥 多样数字人：支持公共数字人和私有数字人形象
• 🎵 多种音色：提供丰富的声音选项
• 🎬 口型同步：自动实现唇形与语音的精准同步
• ⏱️ 快速生成：视频生成时间在30分钟以内

安装要求

1. Python版本：3.10 或更高版本
2. 依赖库：requests 库

配置文件

数字人ID参考（meta-human.json）

包含可用的公共数字人形象ID，用户也可以使用自己在九马官网的私有数字人ID。

音色ID参考（voice.json）

包含可用的公共音色ID，用户也可以使用自己在九马官网的私有音色ID。

登录流程(LOGIN.MD)

包含login.py和utils.py文件调用流程。用户免费使用次数用完后，需要登录后才能生成数字人

工作流程

第一步：询问用户需要生成的文本内容, 或者提供文本音频URL

第二步：询问数字人ID, 公共数字人ID可以免费参考meta-human.json, 或者提供数字人形象URL(图片或视频)

第三步：如果用户提供了音频URL地址, 直接进行下一步; 否则询问音色ID, 公共音色ID提供参考选项

第四步：确认所有参数，开始生成

第五步：如果返回code为406, 表示用户余额不足, 需要扫码 pay_address 充值

第六步：如果返回code为401或405, 执行 LOGIN.md 完整登录流程, 返回地址让用户登录

参数说明

| 参数名 | 类型 | 是否必需 | 描述 | |------------------|--------|--|----------------| | text | string | 是 | 文本内容 或 文本音频URL| | human_id | string | 是 | 数字人ID 或 数字人形象URL| | voice_id | string | 是 | 音色ID | | human_video_id | int | 否 | 任务ID |

使用指南

当用户需要生成数字人视频时，按照以下步骤操作：

1. 收集用户信息

文本内容：

• 提示用户输入文本内容
• 示例：text="大家好，我是AI助手，很高兴为您服务。" 或 text="https://cache.jiuma.com/a.mp3"

数字人ID：

• 提示用户输入数字人ID
• 选项：

- 公共数字人ID（参考 meta-human.json） - 私有数字人ID（九马官网获取）

• 示例：human_id=1234 或 human_id="https://cache.jiuma.com/a.mp4"

音色ID：

• 提示用户输入音色ID
• 选项：

- 公共音色ID（参考 voice.json） - 私有音色ID（九马官网获取）

• 示例：voice_id=6789

2. 资源查找提示

如果用户不知道可用的数字人或音色ID，提供以下帮助：

• 引导用户查看 meta-human.json 和 voice.json 文件
• 提示访问九马官网获取私有资源
• 提供常见组合的示例

如果用户想取消字数限制或体验更多功能, 提供以下帮助：

• 可以扫二维码访问 qrcode_url
• 可以访问网页 login_url

3. 执行生成

• 生成数字人

# OpenClaw中使用
# 提交数字人生成任务
python3 ./skills/jiuma-free-meta-human/generate_video.py --action "create" --text "{{.text}}" --human_id {{.human_id}} --voice_id {{.voice_id}}

• 查询生成数字人的任务状态

# OpenClaw中使用
# 查询任务状态, 建议10-15分钟后查询
 python33 ./skills/jiuma-free-meta-human/generate_video.py --action "check" --human_video_id {{.human_video_id}}

API说明

生成数字人

• 执行命令: python3 ./skills/jiuma-free-meta-human/generate_video.py --action "create" --text "{{.text}}" --human_id {{.human_id}} --voice_id {{.voice_id}}
• 参数:

- action: 操作类型, create表示创建任务; check表示查询任务 - text: 文本内容 或 文本音频URL - human_id: 数字人ID 或 数字人形象URL - voice_id: 音色ID

• 响应结果:

- code: 状态码, 200表示成功; 500表示失败; 401,405 表示需要登录验证; 406 表示余额不足，需要充值 - error: 错误信息 - human_video_id: 任务ID - pay_address: 充值地址

查询生成数字人的任务状态

• 执行命令: python3 ./skills/jiuma-free-meta-human/generate_video.py --action "check" --human_video_id {{.human_video_id}}
• 参数:

- action: 操作类型, create表示创建任务; check表示查询任务 - human_video_id: 任务ID

• 响应结果:

- code: 状态码, 200表示成功; 500表示失败 - message: 返回信息 - status: 任务状态; 17: "远程调度制作失败" | 13: "视频制作中" | 21: "已完成" - video_url: 视频下载链接

交互流程优化

智能引导

1. 第一步：询问用户需要生成的文本内容
2. 第二步：询问数字人ID，同时提供获取方式
3. 第三步：询问音色ID，提供参考选项
4. 第四步：确认所有参数，开始生成
5. 第五步：如果返回code为401或405, 参考LOGIN.md 登录流程, 直到用户登录完成

错误预防

• ID格式验证（确保是整数）
• 生成前二次确认

最佳实践

推荐配置

• 公共数字人：优先使用已验证的公共ID
• 常用音色：选择清晰度高的音色

注意事项

1. 生成过程可能需要30分钟左右，请耐心等待
2. 确保网络连接稳定
3. 生成结果会自动保存到指定目录
4. 如需中断生成，请使用适当的中断方式

故障排除

扩展功能建议

未来可考虑添加：

• 批量生成支持
• 自定义背景功能
• 多语言支持
• 视频格式选择