文档中心

豆包语音

声音复刻

音色查询

查询已音色注册的状态。

POSThttps://openspeech.bytedance.com/api/v3/tts/get_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 --location --request POST 'https://openspeech.bytedance.com/api/v3/tts/get_voice' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: your_api_key' \
  --header "X-Api-Request-Id: $(uuidgen)" \
  --data-raw '{
    "speaker_id": ""
  }'

输出示例

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

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

这个页面对您有帮助吗？

有用

无用