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 完整登录流程, 返回地址让用户登录#

参数说明#

参数名类型是否必需描述textstring是文本内容 或 文本音频URLhuman_idstring是数字人ID 或 数字人形象URLvoice_idstring是音色IDhuman_video_idint否任务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. 执行生成#

• 生成数字人

bash

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

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

bash

# 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. 如需中断生成，请使用适当的中断方式

故障排除#

问题可能原因解决方案ID格式错误非整数或格式不正确检查ID格式生成超时网络或服务器问题稍后重试音视频不同步文本过长或特殊字符简化文本内容

扩展功能建议#

未来可考虑添加：

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