通过订单ID查询购买的音色 ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=ListMegaTTSByOrderID&groupName=%E5%A3%B0%E9%9F%B3%E5%A4%8D%E5%88%BB&serviceCode=speech_saas_prod&version=2023-11-07) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **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 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **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字符串，可发送请求后面的结果; 如果没有更多结果将为空 ## 请求示例 ```text POST /?Action=ListMegaTTSByOrderID&Version=2023-11-07 HTTP/1.1 Host: https://open.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20250418T093726Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250418/cn-beijing/speech_saas_boe/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "AppID": "66666666", "OrderID": "Order20000000000000", "PageNumber": 1, "PageSize": 10, "NextToken": "foobarfoobar", "MaxResults": 10 } ``` ## 返回示例 ```text { "ResponseMetadata": { "RequestId": "202504181737380941721012465EE964", "Action": "ListMegaTTSByOrderID", "Version": "2023-11-07", "Service": "speech_saas_boe", "Region": "cn-beijing" }, "Result": { "OrderBuyQuantity": 1000, "OrderBuyCurrentSuccessQuantity": 100, "OrderBuyCurrentFailedQuantity": 10, "IsAllProcessed": true, "Statuses": [ { "SpeakerID": "S_foobar", "InstanceNO": "Model_storage_mefoobar", "IsActivable": "true", "State": "Training", "DemoAudio": "https://example.com", "Version": "v1", "CreateTime": 1700727790000, "ExpireTime": 1964793599000, "OrderTime": 1701771990000, "Alias": "foobar", "AvailableTrainingTimes": 10 } ], "PageNumber": 10, "PageSize": 10, "TotalCount": 1000, "NextToken": "foobarfoobar" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |OperationDenied.OrderNotProcessed |the queried quantity is empty, the order number is wrong, or the order has not been processed yet |返回结果为空，订单号错误或者订单还没进行处理 |

豆包语音