shield_lock
JinDaGe
Contact
← Back to skills
extension
Category: OtherAPI key required

九马免费对口型数字人

九马AI免费数字人视频生成技能。使用九马AI API进行文本内容或音频内容到数字人视频的生成，支持选择不同数字人形象和音色。当用户需要生成数字人视频时使用此技能。

personAuthor: dddcn1hubclawhub
open_in_newRepositorydownloadDownload package

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

故障排除

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

扩展功能建议

未来可考虑添加：

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