实时音视频
实时音视频
文档指南
请输入
- 文档首页
实时音视频硬件对话智能体服务端 API声音复刻批量查询声音复刻训练任务 BatchListVoiceTrainStatus
复制全文
下载 pdf批量查询声音复刻训练任务 BatchListVoiceTrainStatus
文档反馈
问问助手调用 BatchListVoiceTrainStatus 查询指定音色的声音复刻训练任务列表，支持分页获取训练任务的详细信息，包括训练状态、剩余训练次数、过期时间等核心业务数据。
注意事项
QPS 限制：单账号调用频率不得超过 20 次/秒。
请求说明
- 请求方式：POST
- 请求地址：https://rtc.volcengineapi.com?Action=BatchListVoiceTrainStatus&Version=2020-12-01
请求参数
Query
Action String 必选 示例值：BatchListVoiceTrainStatus
接口名称。当前 API 的名称为 BatchListVoiceTrainStatus。
Version String 必选 示例值：2020-12-01
接口版本。当前 API 的版本为 2020-12-01。
Body
Offset Integer 必选 示例值：0
分页查询的起始位置。默认为 0。
Limit Integer 必选 示例值：10
分页查询时每页显示的最大数量。取值范围：[0, 50]。
返回参数
Total Integer 示例值：100
符合查询条件的声音复刻训练任务总条数，单位为条。
Offset Integer 示例值：0
当前分页查询的起始位置。
Limit Integer 示例值：10
分页查询时，每页显示的数量。
VoiceTrainList Object[] 示例值：-
声音复刻音色详情列表。
AppId String 示例值：66****3cf
音色所属的应用的 AppId。
SpeakId String 示例值：S_BKT****Z1
音色 ID。
ModelName String 示例值：火山-声音复刻大模型
该训练任务使用的声音复刻模型名称。
Cluster String 示例值：volcano_icl
训练任务的计算集群名称。
SpeakName String 示例值：我的专属客服音色
音色名称。
VoiceState String 示例值：Success
音色的当前训练与使用状态，支持以下取值：
- Unknown：状态未知。
- Training：训练中。
- Success：训练成功。
- Active：使用中。
- Expiring：即将过期。
- Expired：已过期。
- Reclaimed：已回收。
AvailableTrainingTimes Integer 示例值：15
该声音 ID 剩余的可训练次数。
ExpireTime String 示例值：2025-12-31T23:59:59Z
声音 ID 过期时间。
DemoAudio String 示例值：https://lf3-lab-speech-tt-sign.bytespeech.com/tos-cn-o-14155/****3D
该训练任务生成的音色 URL，可用于试听训练后的音色效果。
请求示例
POST https://rtc.volcengineapi.com?Action=BatchListVoiceTrainStatus&Version=2020-12-01
{
"SpeakId": "S_BKT****Z1",
"Offset": 0,
"Limit": 10
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20260404110420****100232280022D31",
"Action": "BatchListVoiceTrainStatus",
"Version": "2020-12-01",
"Service": "rtc",
"Region": "cn-north-1"
},
"Result": {
"Total": 100,
"Offset": 0,
"Limit": 10,
"VoiceTrainList": [
{
"AppId": "66****3cf",
"SpeakId": "S_VArpZ****",
"ModelName": "Model_v2.0_General",
"Cluster": "tts-train-cluster-001",
"SpeakName": "我的专属客服音色",
"VoiceState": "Active",
"AvailableTrainingTimes": 3,
"ExpireTime": "2025-12-31T23:59:59Z",
"DemoAudio": "https://example.com/demo/speak_mock16_demo.mp3"
}
]
}
}
错误码
最近更新时间：2026.08.19 18:39:43
这个页面对您有帮助吗？
有用
有用
无用
无用