九马免费对口型数字人

SKILL.md

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

# 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. 执行生成

- **生成数字人**
```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格式 |
| 生成超时 | 网络或服务器问题 | 稍后重试 |
| 音视频不同步 | 文本过长或特殊字符 | 简化文本内容 |

## 扩展功能建议

未来可考虑添加：
- 批量生成支持
- 自定义背景功能
- 多语言支持
- 视频格式选择