文档中心

豆包语音

声音复刻

音色升级

通过声音复刻 V1 接口生成的克隆音色，仅可绑定单个模型产品。升级至声音复刻 V3后，该音色可在音色复刻 1.0、2.0 等多个产品中通用。

本接口用于完成从 V1 版本到 V3 版本的升级操作，若已使用V3版本音色接口则无需再使用该接口进行升级。

POSThttps://openspeech.bytedance.com/api/v3/tts/upgrade_voice

以下请求头主要为新版控制台鉴权参考示例，若使用旧版控制台，鉴权参考示例详见：旧版控制台鉴权参考示例。旧版控制台后续会逐步下线，建议尽快切换至新版控制台使用。

请求头

Content-Type string 必选

固定值："application/json"

X-Api-Key string 必选

API Key 可以从控制台>API Key管理获取

X-Api-Request-Id string 必选

标识客户端请求ID，uuid随机字符串

请求体

speaker_idstring 必选

唯一音色代号，speaker_id获取参考。

custom_speaker_idstring

含义：自定义音色代号（仅支持后付费音色，关于后付费音色下单几说明详见：《声音复刻下单及使用指南》）。

后付费声音复刻示例：

响应

X-Tt-Logid string

服务端返回的 logid，用于在咨询或者反馈时定位问题

code int

请求状态码。请求失败时，HTTP 状态码不为 200，详情请参见错误码参考文档。

message string

请求状态信息。失败时，会返回对应的失败说明，详情请参见错误码参考文档。

available_training_times int

该speaker_id剩余复刻次数

create_time int

创建时间（毫秒）

language int

以下为语种对应的枚举值

cn = 0 中文（默认）

en = 1 英文

ja = 2 日语

es = 3 西班牙语

id = 4 印尼语

pt = 5 葡萄牙语

de = 6 德语

fr = 7 法语

ko = 8 韩语

it = 9：意大利语

th = 10: 泰语

vi = 11: 越南语

ru = 12: 俄语

fil = 13: 菲律宾语

ms = 14: 马来语

ar = 15: 阿拉伯语

mx = 16: 墨西哥西班牙语

pt-br = 17: 巴西葡萄牙语

pl = 19：波兰语

tr = 20：土耳其语

sv = 21：瑞典语

speaker_id string

唯一音色代号

status int

复刻状态，状态为2或4时都可以调用TTS语音合成接口。

NotFound = 0

Training = 1

Success = 2

Failed = 3

Active = 4

speaker_statusobject list

model_type int

复刻 2.0：model_type = 5

demo_audio string

试听音频。Success状态时返回，一小时有效，若需要，请下载后使用

cURL

Python

Java

输入示例

curl -X POST "https://openspeech.bytedance.com/api/v3/tts/upgrade_voice" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: your_api_key" \
  -H "X-Api-Request-Id: $(uuidgen)" \
  -d '{
    "speaker_id": ""
  }'

输出示例

{
    "available_training_times": 15,
    "create_time": 1772026663000,
    "language": 0,
    "speaker_id": "S_*******",
    "speaker_status": [
        {
            "demo_audio": "https://x.bytespeech.com/S_*******",
            "model_type": 1
        },
        {
            "demo_audio": "https://x.bytespeech.com/S_*******",
            "model_type": 5
        }
    ],
    "status": 2
}

最近更新时间：2026.09.29 19:02:57

这个页面对您有帮助吗？

有用

无用