GALAXY EYE
  • 开放文档
  • 声纹复刻
Galaxyeye
2024-07-10
目录

声音复刻API

# 1.创建声音训练任务

# 接口描述

# 输入参数

参数为form表单：

参数名称 必选 字段类型 描述
files 是 file 音频文件。（5个音频文件，需要严格按照文案的顺序）具体要求参见音频规范
taskName 是 String 训练任务名称，20字以内（只支持中文，英文，数字）
callBackUrl 否 String 训练任务状态回调地址 经历训练回调接口

# 输出参数

参数名称 必选 字段类型 说明
code 是 int 状态码
msg 是 String 状态描述信息
success 是 boolean true： 成功；false：失败
data 是 object 业务数据
data.taskId 是 String 训练任务ID

# 示例

  • 输入示例: Untitled

  • 输出示例：

{
    "msg": "OK",
    "code": 0,
    "success": true,
    "data":{
        "taskId":"30a6f256-0526-11ef-a395-XXXXXXXX"
    }
}

# 2.训练状态查询

# 接口描述

# 输入参数

参数名称 必选 类型 说明
taskIds 是 array 训练任务ID，一次性最多可查询50个

# 输出参数

参数名称 必选 类型 说明
code 是 int 状态码
msg 是 String 状态描述信息
success 是 boolean true： 成功；false：失败
data 是 object 业务数据
data.taskId 是 string 任务号
data.failReason 否 string 失败原因
data.sound 是 String 声音标识
data.taskStatus 是 int 任务状态; 1-训练中 2-训练成功 3-训练失败

# 示例

  • 输入示例:

https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/soundTask/querySoundTask

{
    "taskIds": [
        "30a6f256-0526-11ef-a395-XXXXXXXX"
    ]
}
  • 输出示例：
{
    "msg": "ok",
    "code": 0,
    "success":true,
    "data": [{
        "taskNo": "30a6f256-0526-11ef-a395-XXXXXXXX",
        "sound": "gecv_sovits_xxxxx",
        "taskStatus": 2
    }]
}

# 快速测试

  • curl
curl --location --request POST 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/soundTask/querySoundTask \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskIds": [
        "30a6f256-0526-11ef-a395-XXXXXXXX"
    ]
}'

# 3.训练结果回调

# 接口描述

  • 接口地址：/xxx/taskStatusCallBack(接口名称仅作示例，开发者可自定义)

  • 请求方式： HTTP POST

  • 请求类型：application/json; charset=utf-8

  • 特别说明： 回调地址端口仅支持默认80或443端口

# 输入参数

参数名称 必选 类型 说明
taskId 是 string 任务id
taskStatus 是 int 任务状态（ 2:训练成功 3:训练失败）
sound 否 声音标识，训练成功返回
failReason 否 string 失败原因

# 输出参数

北冥复刻人系统在回调该接口时不解析参数内容，http状态码为200即代表回调成功。因此，输出参数可由开发者自行定义，此处定义仅做参考。

参数名称 必选 类型 说明
code 是 int 状态码
msg 是 String 状态描述信息
success 是 boolean true： 成功；false：失败

# 示例

  • 输入示例:
{
    "taskNo": "30a6f256-0526-11ef-a395-XXXXXXXX",
    "sound": "gecv_sovits_xxxxx",
    "taskStatus": 2
}
  • 输出示例：
{
    "code":0,
    "msg":"ok",
    "success":true
}

# 4.语音合成（HTTP)

# HTTP

文本全部合成完毕之后，一次性返回全部的音频数据

# 5.声音销毁

# 接口描述

# 输入参数

参数名称 必选 类型 说明
taskId 是 string 声音对应的训练任务ID

# 输出参数

参数名称 必选 类型 说明
code 是 int 状态码
msg 是 String 状态描述信息
success 是 boolean true： 成功；false：失败

# 示例

  • 输入示例: https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/soundTask/deleteSoundTask
{
    "taskId": "30a6f256-0526-11ef-a395-XXXXXXXX"
}
  • 输出示例：
{
    "msg": "ok",
    "code": 0,
    "success":true
}

# 快速测试

  • curl
curl --location --request POST 'https://open.galaxyeye-api.com/intellect-saas-v4/v1/open/soundTask/deleteSoundTask \
--header 'X-Bm-Access-Token: ****yMjc3LCJhY2Nlc3NLZXkiOiJlZTg4OGYyMjY1MGI0YzdkYjExODA0ZWFkNTQyMmEwMyIsImp3dF90b2tlbl9pZCI6ImU4NjljYTc3LTJiMjctNDBjZC04Yzg4LWE1ODY5NWJlN2Q2NiIsInRlbmFudElkIjoiODUyNTM1NTE0MTIwMDYwOTI4Iiwiand0X3Rva2VuX3R5cGUiOjN9.U5QYuSI-ymzTm6QcAHs2ow1MV3BTXwsACWDGaSeW84Y' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskId": "30a6f256-0526-11ef-a395-XXXXXXXX"
}'

# 6.状态码

返回码 返回码说明 备注
0 OK
11305 taskName不符合要求！
12100 声音训练失败，请稍后重试！
8604 第1个音频校验不通过，解析出来的文案：xxx 请仔细校验！
51003 token数量不足 租户token不足，请充值！
54011 未开通接口权限 参数异常，请仔细检查参数
11304 请上传5个音频文件！
54010 声音任务服务器异常，请重试!
56008 声音训练taskId个数超出上限
58009 声音训练任务不存在！
58010 声音训练任务不属于当前租户！
58013 声音训练任务正在训练中
上次更新: 2024/08/10, 14:38:02
声纹复刻录音指导
公共发音人列表

← 公共发音人列表→

Theme by Vdoing