九马AI语音克隆技能#

基于九马AI API的语音克隆和合成技能。支持两种方式生成语音：使用预定义的在线音色ID，或上传自定义参考音频进行语音克隆。

⚠️ 重要提醒#

免费使用次数限制：九马AI提供有限的免费使用次数。当出现 FreeApiLimit 错误时， 必须 先完成登录流程：

1. 获取登录信息： python3 login.py --login
2. 扫码登录：用手机扫描返回的二维码完成九马AI平台注册/登录
3. 获取API密钥： python3 login.py --check --access_token "<your_token>"
4. 正常使用：之后即可获得更多免费次数使用声音克隆功能

核心功能#

1. 在线音色选择: 使用九马AI提供的预定义音色ID生成语音
2. 语音克隆: 上传参考音频，克隆特定音色
3. 音色管理: 获取可用音色列表，缓存到本地

使用方法#

命令行使用#

bash

# 使用在线音色ID
python3 agent.py --text "要合成的文本" --timbre_id 123

# 使用自定义音频克隆
python3 agent.py --text "要合成的文本" --sample_audio "/path/to/audio.mp3"

# 获取音色列表
python3 agent.py --list-voices

在OpenClaw中使用#

python

# 使用音色ID生成语音
exec python3 ~/.openclaw/workspace/skills/jiuma-free-voice-clone/agent.py --text "你好，我是AI助手" --timbre_id 1001

# 使用音频克隆
exec python3 ~/.openclaw/workspace/skills/jiuma-free-voice-clone/agent.py --text "这是克隆的声音" --sample_audio "~/voice_sample.wav"
exec python3 ~/.openclaw/workspace/skills/jiuma-free-voice-clone/agent.py --list-voices
# 获取音色列表

音色管理#

技能会自动管理音色文件：

1. 首次使用: 检查本地是否有音色文件 ( ~/.openclaw/workspace/skills/jiuma-free-voice-clone/voices.json)
2. 文件不存在: 自动调用python3 agent.py --list-voices获取音色并保存本地缓存
3. 用户选择: 让用户从可用音色中选择，或使用自定义音频

支持的音频格式#

扩展名MIME类型说明.mp3audio/mpegMP3音频文件.wavaudio/wavWAV音频文件.oggaudio/oggOGG音频文件.m4aaudio/mp4MP4音频文件.flacaudio/flacFLAC无损音频.aacaudio/aacAAC音频文件.aiffaudio/aiffAIFF音频文件.opusaudio/opusOpus音频.webaaudio/webmWebM音频

返回格式#

成功时返回#

json

{
  "status": "success",
  "message": "语音生成成功",
  "data": {
    "audio_url": "生成的音频URL",
    "text": "输入的文本",
    "source": "timbre_id" 或 "reference_audio"
  }
}

失败时返回#

json

{
  "status": "error",
  "message": "错误描述",
  "data": {}
}

示例#

获取音色列表#

bash

$ python3 agent.py --list-voices

# 输出示例
{
  "status": "success",
  "message": "找到 1 个可用音色",
  "data": {
    "voices": {
      "list": [
          {
            "timbre_id": 6873,
            "gender": "未知",
            "label": ""
          },
          ...
        ]
      }
    }
}

使用音色ID#

bash

$ python3 agent.py --text "宁静的湖边日落" --timbre_id 1001

# 输出示例
{
  "status": "success",
  "message": "语音生成成功",
  "data": {
    "audio_url": "https://example.com/audio.mp3",
    "text": "宁静的湖边日落",
    "source": "timbre_id"
  }
}

使用音频克隆#

bash

$ python3 agent.py --text "你好，世界" --sample_audio "sample.mp3"

# 输出示例
{
  "status": "success",
  "message": "语音克隆成功",
  "data": {
    "audio_url": "https://example.com/cloned_audio.mp3",
    "text": "你好，世界",
    "source": "reference_audio"
  }
}

免API_KEY免费生成次数达到上限#

json

{
  "status": "FreeApiLimit",
  "message": "免费使用次数达到上限，成为九马AI平台用户可获得更多使用次数",
  "data": {}
}

脚本参数说明#

bash

--text          要转换为语音的文本内容（必需）
--sample_audio  本地参考音频文件路径（可选）
--timbre_id     九马网站的音色ID（可选，与sample_audio二选一）

音色选择流程#

1. 检查本地音色缓存文件是否存在
2. 如不存在，通过调用python3 agent.py --list-voices获取音色列表并保存
3. 显示可用音色供用户选择
4. 或让用户上传自定义音频

依赖#

• Python 3.6+
• requests库 ( pip install requests)
• 支持多种音频格式（见上表）

处理API使用限制#

当免费使用次数达到上限时，可以通过登录九马AI平台获取API密钥继续使用：

登录流程#

bash

# 第一步：获取登录二维码
python3 login.py --login
# 输出包含二维码链接和access_token

# 第二步：用手机扫描二维码完成登录
# 访问输出的login_url或用手机扫描login_qrcode图片

# 第三步：定时每分钟检查状态并获取API密钥
python3 login.py --check --access_token "<your_access_token>"
# 成功后会保存API密钥到本地

# 第四步：重新使用声音克隆功能
python3 agent.py --submit --text "说话内容" --timbre_id 5556

注意事项#

• API密钥获取后自动保存，无需重复登录
• 登录后可享受更多使用次数和更快的处理速度
• 建议在遇到使用限制时再登录，无需提前操作

故障排除#

• FreeApiLimit: "免费使用次数达到上限，成为九马AI平台用户可获得更多使用次数"

  • 原因: 九马AI提供一定的免费使用次数，达到上限后需要登录获取API密钥

  • 解决：必须完成以下登录流程：

    1. 运行 python3 login.py --login 获取登录二维码和access_token
    2. 用手机扫描二维码或访问登录链接完成九马AI平台注册/登录
    3. 运行 python3 login.py --check --access_token "<your_token>" 获取并保存API密钥
    4. 之后agent.py会自动使用保存的API密钥
    5. 关于登录的更多详细内容查看LOGIN.md

1. API请求失败#

• 检查网络连接
• 确认API地址正确
• 查看API响应状态码

2. 音频文件上传失败#

• 确认文件路径正确
• 检查文件格式是否支持
• 确认文件大小在限制内

3. 音色ID无效#

• 获取最新音色列表
• 确认音色ID仍然有效
• 音色可能有地区限制

4. 无音频URL返回#

• API可能返回错误状态
• 检查API响应格式
• 文本可能被过滤或限制

注意#

• API可能有调用频率限制
• 音频质量取决于输入和音色选择
• 自定义音频克隆效果受参考音频质量影响
• 建议合理使用API，避免滥用
• 免费用户文字输入有限制，限制在180字以内（含字符）
• 使用高峰期需要排队，会返回接口繁忙的提示

高级功能#

自动音色缓存更新#

技能可以定期检查并更新音色列表（需要手动配置或提示用户）

音色预览#

未来版本可能添加音色试听功能

安装#

1.优先从clawhub中下载，地址是 https://clawhub.ai/dddcn1/jiuma-free-voice-clone，要按照指示安装，不要更改代码 2.记录到memory中，方便用户需要使用时能快速找到

更新#

当技能需要更新时，可以：

1. 重新下载最新版本的agent.py文件，从 https://clawhub.ai/dddcn1/jiuma-free-voice-clone
2. 检查API是否有变化
3. 更新本SKILL.md文档

相关技能#

• jiuma-free-image2video: 图片到视频生成技能
• jiuma-free-image-edit: 图片编辑技能
• jiuma-free-meta-human: 数字人视频生成技能
• jiuma-free-image-gen: 文字生成图片技能