1. 请求方式

域名： https://openspeech.bytedance.com
具体请求方式可参考下方示例代码

uploadAndStatus.py

未知大小

2. 训练（upload接口）

接口路径: POST/api/v1/mega_tts/audio/upload
接口描述: 提交音频训练音色
认证方式使用Bearer Token，在请求的header中加上"Authorization": "Bearer; {token}"，并在请求的json中填入对应的appid。

请求参数

Header:

Body:

json示例

{
        "speaker_id": "S_*******",
        "appid": "your appid",
        "audios": [{
                "audio_bytes": "base64编码后的音频",
                "audio_format": "wav"
        }],
        "source": 2,
        "language": 0,
        "model_type": 1
}

返回数据

Body:

json示例

{
    "BaseResp":{
        "StatusCode":0,
        "StatusMessage":""
    },
    "speaker_id":"S_*******"
}

3. 返回码：

4. 状态查询（status接口）

接口路径: POST/api/v1/mega_tts/status
接口描述: 查询音色训练状态

请求参数

Header:

Body:

json示例

{
    "appid": "your appid",
    "speaker_id": "S_*******"
}

返回数据

Body:

json示例

{
    "BaseResp":{
        "StatusCode":0,
        "StatusMessage":""
    },
    "creaet_time":1701055304000,
    "version": "V1",
    "demo_audio": "http://**********.wav"
    "speaker_id":"S_*******",
    "status":2
}

接口调用方式与TTS一致，可以参考如下链接，将参数做对应修改后即可使用。

Websocket

使用账号申请部分申请到的appid&access_token进行调用
文本一次性送入，后端边合成边返回音频数据

HTTP

使用账号申请部分申请到的appid&access_token进行调用
文本全部合成完毕之后，一次性返回全部的音频数据

备注：

1. 暂时不支持时间戳能力
2. 暂时不支持ssml能力
3. 暂时不支持音高、音量、语速调节
4. 大模型音色语种支持中英混
5. 大模型声音复刻支持语种自动识别

请求示例

{
    "app": {
        "appid": "appid123",
        "token": "access_token",
        "cluster": "volcano_icl"
    },
    "user": {
        "uid": "uid123"
    },
    "audio": {
        "voice_type": "S_xxxx",
        "encoding": "mp3",
        "speed_ratio": 1
    },
    "request": {
        "reqid": "uuid",
        "text": "字节跳动语音合成",
        "operation": "query"
    }
}

响应示例

{
    "reqid": "reqid",
    "code": 3000,
    "operation": "query",
    "message": "Success",
    "sequence": -1,
    "data": "base64 encoded binary data",
    "addition": {
        "duration": "1960"
    }
}

1. 错误返回：

   "message": "quota exceeded for types: xxxxxxxxx_lifetime"
   错误原因：试用版用量用完了，需要开通正式版才能继续使用

2. 错误返回：

"message": "quota exceeded for types: concurrency"
错误原因：并发超过了限定值，需要减少并发调用情况或者增购并发

3. 错误返回：

   "message": "Fail to feed text, reason Init Engine Instance failed"
   错误原因：voice_type / cluster 传递错误

4. 错误返回：

"message": "illegal input text!"
错误原因：传入的text无效，没有可合成的有效文本。比如全部是标点符号或者emoji表情，或者使用中文音色时，传递日语，以此类推。多语种音色，也需要使用language指定对应的语种

5. 错误返回：

"message": "authenticate request: load grant: requested grant not found"
错误原因：鉴权失败，需要检查appid&token的值是否设置正确，同时，鉴权的正确格式为
headers["Authorization"] = "Bearer;${token}"

6. 错误返回：

"message': 'extract request resource id: get resource id: access denied"
错误原因：语音合成已开通正式版且未拥有当前音色授权，需要在控制台购买该音色才能调用。标注免费的音色除BV001_streaming及BV002_streaming外，需要在控制台进行下单（支付0元）

API接入说明

访问鉴权

1. 鉴权方式说明 公共参数--API签名调用指南-火山引擎 (volcengine.com)

线上请求地址域名 open.volcengineapi.com

2. 固定公共参数

Region = "cn-north-1"
Service = "speech_saas_prod"
Version = "2023-11-07"
解释

3. AKSK获取 访问控制-火山引擎 (volcengine.com)

说明：Access Key（密钥）管理--API访问密钥（Access Key）-火山引擎 (volcengine.com)

4. 调用方式
   1. SDK SDK概览--API签名调用指南-火山引擎 (volcengine.com)
   2. 直接签名后调用

结合文档内api说明调用 ListMegaTTSTrainStatus 的例子(*其他语言和使用sdk调用的方式请参考火山鉴权源码说明 一)

3. 示例代码：

sign.go

未知大小

sign.py

未知大小

sign.java

未知大小

错误码

1. 非 2xx 开头的HTTP返回状态码被可以认为是错误
2. 错误的HTTP返回结构体如下

{
    "ResponseMetadata": 
    {
        "RequestId": "20220214145719010211209131054BC103", // header中的X-Top-Request-Id参数
        "Action": "ListMegaTTSTrainStatus",
        "Version": "2023-11-07",
        "Service": "{Service}",// header中的X-Top-Service参数
        "Region": "{Region}", // header中的X-Top-Region参数
        "Error": 
        {
            "Code": "InternalError.NotCaptured",
            "Message": "xxx"
        }
    }
}

3. "ResponseMetadata.Error.Code" 客户端可以依照这个字段判断错误种类，已知种类和含义如下

API列表

1. 查询 SpeakerID 状态

a. Description
查询已购买的音色状态；如果SpeakerIDs为空则返回账号的AppID下所有的列表（有最大值限制1000）；如果SpeakerIDs不为空则返回对应的结果，且结果总是包含输入的SpeakerID（即使查询不到它）
b. Method: POST
c. Request

d. Response

{
          "ResponseMetadata": {
              "RequestId": "20220214145719010211209131054BC103", // header中的X-Top-Request-Id参数
              "Action": "",
              "Version": "",
              "Service": "{Service}",// header中的X-Top-Service参数
              "Region": "{Region}" // header中的X-Top-Region参数
          },
          "Result":{
                  "Statuses": [
                         {
                              "CreateTime": 1700727790000, // unix epoch格式的创建时间，单位ms
                              "DemoAudio": "https://example.com", // http demo链接
                              "InstanceNO": "Model_storage_meUQ8YtIPm", // 火山引擎实例number
                              "IsActivable": true, // 是否可激活
                              "SpeakerID": "S_VYBmqB0A", // speakerID
                              "State": "Success", // speakerID的状态
                              "Version": "V1", // speakerID已训练过的次数
                              "ExpireTime": 1732895999000, //过期时间
                              "Alias": "", //别名，和控制台同步
                              "AvailableTrainingTimes": 9 //剩余训练次数，激活音色为0
                        },
                        {
                              "SpeakerID": "S_VYBmqB0B", // speakerID
                              "State": "Unknown", // speakerID的状态
                        }
                  ]
          }
      }

e. State of speakerID is an enum with possible values of:

3. 分页查询SpeakerID状态 BatchListMegaTTSTrainStatus

a. Description
查询已购买的音色状态；相比ListMegaTTSTrainStatus 增加了分页相关参数和返回；支持使用token和声明页数两种分页方式；其中，

• 分页token在最后一页为空
• 分页token采用私有密钥进行加密
• 分页接口为新接口，不影响已有接口行为

b. Method: POST
c. Request

d. Response

{
    "ResponseMetadata": 
    {
        "RequestId": "20220214145719010211209131054BC103", // header中的X-Top-Request-Id参数
        "Action": "BatchListMegaTTSTrainStatus",
        "Version": "2023-11-07",
        "Service": "{Service}",// header中的X-Top-Service参数
        "Region": "{Region}" // header中的X-Top-Region参数},
        "Result":
        {
            "AppID": "xxx",
            "TotalCount": 2, // speakerIDs总数量
            "NextToken": "", // NextToken字符串，可发送请求后面的结果; 如果没有更多结果将为空
            "PageNumber": 1, // 使用分页参数时的当前页数
            "PageSize": 2, // 使用分页参数时当前页包含的条数
            "Statuses": 
            [
                {
                    "CreateTime": 1700727790000, // unix epoch格式的创建时间，单位ms
                    "DemoAudio": "https://example.com", // http demo链接
                    "InstanceNO": "Model_storage_meUQ8YtIPm", // 火山引擎实例Number
                    "IsActivable": true, // 是否可激活
                    "SpeakerID": "S_VYBmqB0A", // speakerID
                    "State": "Success", // speakerID的状态
                    "Version": "V1" // speakerID已训练过的次数
                },
                {
                    "SpeakerID": "S_VYBmqB0B", // speakerID
                    "State": "Unknown", // speakerID的状态
                    "Version": "V1" // speakerID已训练过的次数
                }
            ]
        }
}