文档中心

Appearance

音色克隆API ​

音色状态说明 ​

音色在训练过程中会经历以下状态：

  • Init: 初始状态，刚创建的音色栏位
  • Training: 训练中，正在处理音频文件
  • Success: 训练成功，音色可以正常使用
  • Failed: 训练失败，需要重新训练

1. 创建音色栏位 ​

创建音色栏位

创建一个新的音色栏位，为后续的音色训练做准备。创建成功后会返回音色ID和默认名称。(注意：音色栏位创建后，语言不可修改！)

POSThttps://xrobo.qiniu.com/v1/voice-clones
点击展开

基本信息

Host:https://xrobo.qiniu.com
Base Path:
Method:POST
返回类型:application/json

请求参数

参数名类型必填位置说明
languagestring否-音色语言，默认为 "zh"。免费版仅支持 zh(中文) 和 en(英语)，其他语言需使用 pro(付费) 版本：ja(日语), ko(韩语), es(西班牙语), pt(葡萄牙语), id(印尼语), de(德语), fr(法语), ar(阿拉伯语), hi(印地语), it(意大利语), tr(土耳其语), yue(粤语)
tierstring否-付费等级，默认为 "free"，支持以下等级：free(免费), pro(付费)

请求头

Header名类型必填说明
Authorizationstring是Bearer token认证
Content-Typestring是请求内容类型

请求示例 

{
  "language": "zh",
  "tier": "free"
}

响应示例 

{
    "code": 0,
    "reqid": "0zooABHhub9fUgYA",
    "data": {
        "id": "95da00f77ad24c5ea246618b2a678cc6",
        "name": "复刻音色-78cc6",
        "language": "zh",
        "demo_url": "",
        "state": "Init",
        "tier": "free"
    }
}

状态码

0创建成功
400请求参数错误
401未授权访问
500服务器内部错误

2. 训练音色 ​

训练音色

使用音频文件训练指定的音色，或仅更新音色名称。 如果提供音频URL，系统将根据音频进行训练；如果仅提供名称，则只更新音色名称。

PUThttps://xrobo.qiniu.com/v1/voice-clones/{id}
点击展开

基本信息

Host:https://xrobo.qiniu.com
Base Path:
Method:PUT
返回类型:application/json

请求参数

参数名类型必填位置说明
idstring是-音色唯一标识符，由创建音色栏位接口返回
keystring否-音频文件URL。为空时仅修改名称，不为空时根据音频文件进行训练
namestring是-音色名称，限制20字符以内（汉字/字母/数字都算一个字符）

请求头

Header名类型必填说明
Authorizationstring是Bearer token认证
Content-Typestring是请求内容类型

请求示例 

{
  "key": "https://example.com/voice-sample.wav",
  "name": "我的专属音色"
}

响应示例 

{
    "code": 0,
    "reqid": "-qM3AFjdjsVfUgYA",
    "data": {
        "id": "f54b728eb9eb4faf960d82fdfcc6403a",
        "name": "复刻音色-6403a",
        "language": "zh",
        "demo_url": "https://example.com/demo.wav",
        "state": "Training",
        "tier": "free"
    }
}

状态码

0训练请求提交成功
400请求参数错误
401未授权访问
404音色不存在
500服务器内部错误

INFO

  1. 付费复刻: 付费音色栏位在进行音色复刻时，会消耗复刻音色额度！（仅更新名称时不会消耗）
  2. 音色名称限制: 音色名称最多20个字符，汉字、字母、数字都算作一个字符
  3. 音频文件要求: 训练音频建议时长在10-60秒之间，音质清晰，无背景噪音
  4. 训练时间: 音色训练通常需要几分钟到十几分钟，请耐心等待

3. 获取音色信息 ​

获取音色信息

根据音色ID获取指定音色的详细信息，包括名称、语言、试听链接和当前状态。

GEThttps://xrobo.qiniu.com/v1/voice-clones/{id}
点击展开

基本信息

Host:https://xrobo.qiniu.com
Base Path:
Method:GET
返回类型:application/json

请求参数

参数名类型必填位置说明
idstring是-音色唯一标识符

请求头

Header名类型必填说明
Authorizationstring是Bearer token认证

响应示例 

{
  "code": 0,
  "msg": "",
  "reqid": "req_12345678",
  "data": {
    "id": "voice_clone_abc123",
    "name": "我的专属音色",
    "language": "zh",
    "demo_url": "https://example.com/demo.wav",
    "state": "Success",
    "tier": "free"
  }
}

状态码

0获取成功
401未授权访问
404音色不存在
500服务器内部错误

INFO

状态检查: 只有状态为"Success"的音色才能正常使用

4. 获取音色列表 ​

获取音色列表

获取当前用户账户下所有的音色克隆列表，包括各种状态的音色。

GEThttps://xrobo.qiniu.com/v1/voice-clones
点击展开

基本信息

Host:https://xrobo.qiniu.com
Base Path:
Method:GET
返回类型:application/json

请求头

Header名类型必填说明
Authorizationstring是Bearer token认证

响应示例 

{
  "code": 0,
  "msg": "",
  "reqid": "req_12345678",
  "data": {
    "voices": [
      {
        "id": "voice_clone_abc123",
        "name": "我的专属音色",
        "language": "zh",
        "demo_url": "https://example.com/demo1.wav",
        "state": "Success",
        "tier": "free"
      },
      {
        "id": "voice_clone_def456",
        "name": "复刻音色-X9Y8Z",
        "language": "",
        "demo_url": "",
        "state": "Training",
        "tier": "pro"
      }
    ]
  }
}

状态码

0获取成功
401未授权访问
500服务器内部错误

5. 删除音色 ​

删除音色

删除指定的音色克隆。删除后该音色将无法恢复，请谨慎操作。(付费音色栏位不可删除！)

DELETEhttps://xrobo.qiniu.com/v1/voice-clones/{id}
点击展开

基本信息

Host:https://xrobo.qiniu.com
Base Path:
Method:DELETE
返回类型:application/json

请求参数

参数名类型必填位置说明
idstring是-待删除的音色唯一标识符

请求头

Header名类型必填说明
Authorizationstring是Bearer token认证

响应示例 

{
  "code": 0,
  "msg": "",
  "reqid": "req_12345678",
  "data": {}
}

状态码

0删除成功
401未授权访问
403付费音色栏位不可删除
404音色不存在
500服务器内部错误

WARNING

删除音色后无法恢复，请谨慎操作