查询已购买的音色状态信息，支持按SpeakerIDs和State过滤。

如果查询条件为空，返回账号的AppID下所有的列表（音色超过1000，强烈建议使用分页接口BatchListMegaTTSTrainStatus）。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListMegaTTSTrainStatus

要执行的操作，取值：ListMegaTTSTrainStatus。

Version string 必选示例值：2025-05-21

API的版本，取值：2025-05-21。

ProjectName string 必选示例值：xxx

火山项目名称

SpeakerIDs string[] 可选示例值：S_x123

SpeakerID的列表，传空为返回指定ProjeceName下的全部SpeakerID

State string 必选示例值：Training

音色状态，支持取值：Unknown、Training、Success、Active、Expired、Reclaimed

详见附录：State状态枚举值

OrderTimeStart long 可选示例值：1752204841000

下单时间检索上边界毫秒级时间戳，受实例交付速度影响，可能比支付完成的时间晚

OrderTimeEnd long 可选示例值：1752204841000

下单时间检索下边界毫秒级时间戳，受实例交付速度影响，可能比支付完成的时间晚

ExpireTimeStart long 可选示例值：1752204841000

实例到期时间的检索上边界毫秒级时间戳

ExpireTimeEnd long 可选示例值：1752204841000

实例到期时间的检索下边界毫秒级时间戳

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Statuses object[] 示例值：参考响应示例

音色列表

SpeakerID string 示例值：S_foobar

音色ID

InstanceNO string 示例值：Model_storage_mefoobar

火山引擎实例Number

IsActivable string 示例值：true

是否可激活

State string 示例值：Training

音色状态，Unknown、Training、Success、Active、Expired、Reclaimed

详见附录：State状态枚举值

DemoAudio string 示例值：https://example.com

试听url公网链接，只有success和active状态有

Version string 示例值：v1

SpeakerID已训练过的次数

CreateTime long 示例值：1700727790000

unix epoch格式的创建时间，单位ms

ExpireTime long 示例值：1964793599000

到期时间, 为空的时候表示永远生效

OrderTime long 示例值：1701771990000

下单时间

Alias string 示例值：foobar

模型别名，和控制台同步

AvailableTrainingTimes integer 示例值：10

剩余训练次数

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter %s is invalid.
400	OperationDenied.InvalidSpeakerID	illegal status to update
400	OperationDenied.InvalidInstanceNO	illegal instance number

SDK

下表提供了豆包语音支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包、查看指导文档。

类别	编程语言	Github地址
SpeechSaasProd	Java	volcengine-java-sdk
		Go	volcengine-go-sdk
		Python	volcengine-python-sdk
		PHP	volcengine-php-sdk