通过订单ID查询购买的音色

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：ListMegaTTSByOrderID

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

Version string 必选示例值：2023-11-07

API的版本，取值：2023-11-07。

AppID string 必选示例值：66666666

AppID

OrderID string 必选示例值：Order20000000000000

订单ID

PageNumber integer 可选示例值：1

页数, 需大于0, 默认为1

PageSize integer 可选示例值：10

每页条数, 必须在范围[1, 100]内, 默认为10

NextToken string 可选示例值：foobarfoobar

上次请求返回的字符串; 如果不为空的话, 将覆盖PageNumber及PageSize的值

MaxResults integer 可选示例值：10

与NextToken相配合控制返回结果的最大数量; 如果不为空则必须在范围[1, 100]内, 默认为10

返回参数

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

OrderBuyQuantity integer 示例值：1000

订单批量购买音色的数量

OrderBuyCurrentSuccessQuantity integer 示例值：100

订单当前购买成功的数量

OrderBuyCurrentFailedQuantity integer 示例值：10

订单当前购买失败的数量

IsAllProcessed boolean 示例值：true

订单是否已经全部处理完

Statuses object[] 示例值：[{ "SpeakerID": "S_dqruHGrp1", "InstanceNO": "Model_storage_GhufMjpN8lIdqij8", "IsActivatable": false, "State": "Unknown", "DemoAudio": null, "Version": null, "CreateTime": 0, "ExpireTime": 1776527999000, "OrderTime": 1744950286000, "Alias": "", "AvailableTrainingTimes": 10 }, { "SpeakerID": "S_bpHuHGrp1", "InstanceNO": "Model_storage_LUmoWq4D9Ny-hDjm", "IsActivatable": false, "State": "Unknown", "DemoAudio": null, "Version": null, "CreateTime": 0, "ExpireTime": 1776527999000, "OrderTime": 1744950286000, "Alias": "", "AvailableTrainingTimes": 10 } ]

音色列表

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

剩余训练次数

PageNumber integer 示例值：10

使用分页参数时的当前页数

PageSize integer 示例值：10

使用分页参数时当前页包含的条数

TotalCount integer 示例值：1000

音色总数量，这里理论上和OrderBuyCurrentSuccessQuantity相等

NextToken string 示例值：foobarfoobar

NextToken字符串，可发送请求后面的结果; 如果没有更多结果将为空

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	OperationDenied.OrderNotProcessed	the queried quantity is empty, the order number is wrong, or the order has not been processed yet	返回结果为空，订单号错误或者订单还没进行处理

豆包语音