tencent cloud

All product documents
Tencent Cloud AI Digital Human
Querying Timbre Lists by Pagination
Last updated: 2025-01-17 16:34:12
Querying Timbre Lists by Pagination
Last updated: 2025-01-17 16:34:12
Query customer-owned timbre lists by pagination, including replicated voices and public timbres.

Calling Protocol

HTTPS + JSON
POST /v2/ivh/crmserver/customerassetservice/describetimbre
Header Content-Type: application/json;charset=utf-8

Request Parameters

Parameter
Type
Mandatory
Description
PageIndex
int
Yes
Current page
PageSize
int
Yes
Page size (maximum of 100)

Response Parameter

Parameter
Type
Mandatory
Description
TimbreAssets
Array of [TimbreAssetDetail]
Yes
Timbre Asset Information
Total
int
Yes
Totals
TimbreAssetDetail
Parameter
Type
Mandatory
Description
TimbreKey
string
Yes
Digital human timbre code
TimbreName
string
Yes
Digital human timbre name
TimbreSample
string
Yes
Digital human timbre demo sample URL
TimbreDesc
string
Yes
Digital human timbre description
SupportVirtualmanTypeCodes
Array of [string]
Yes
Timbre-supported digital human type code, see Appendix 3-Digital Human Type.
SupportDriverTypes
Array of [string]
Yes
Timbre-supported Drive Type
1. Text: Text-driven
2. OriginalVoice: Original voice audio-driven
3. ModulatedVoice: Modulated voice audio-driven
ExpireDate
string
Yes
Validity Period
AudioDuration
int
Yes
Total accumulated duration for calling the audio, in milliseconds.
AudioNum
int
Yes
Total accumulated duration for calling the audio, in milliseconds.
EmotionalCategories
Array of [string]
No
A list of emotional styles supported by the timbre. Data is available only for multi-emotion timbres. See Appendix II for details.
TimbreGender
int
Yes
Timbre Gender; 1: male; 2: female
PurchaseType
string
Yes
Purchase Type, Lease: lease, Custom; customize.
TimbreType
string
Yes
Timbre Type
Boutique: boutique
SampleBasic: Avatar basic edition
SampleFast: Avatar ultra edition
TimbreLanguages
Array of [string]
No
The list of languages supported by timbre, only some timbres support multiple languages, see Appendix 4 - Language List for details.

Request Sample:

{
"Header": {},
"Payload": {
"PageIndex": 1,
"PageSize": 10
}
}

Response Sample

{
"Header": {
"Code": 0,
"Message": "",
"RequestID": "123"
},
"Payload": {
"TimbreDetails": [
{
"TimbreKey": "xxx",
"TimbreName": "female voice 1",
"TimbreSample": "url",
"TimbreDesc": "Natural and graceful",
"SupportVirtualmanTypeCodes": [
"small_sample_2d"
],
"SupportDriverTypes": [
"Text",
"OriginalVoice"
],
"ExpireDate": "2023-04-01 00:00:00",
"AudioDuration": 50000,
"AudioNum": 3,
"TimbreGender": 2,
"PurchaseType": "Lease",
"TimbreType": "Boutique"
}
],
"Total": 1
}
}

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

7x24 Phone Support