tencent cloud

Tencent Cloud AI Digital Human

Product Overview
Overview
Product Features
Product Advantage
Purchase Guide
Pricing Guide
Purchase Guide
Process for Purchasing with Vouchers
Refund Instructions
Introduction of Avatar
Introduction to Image Categories
Basic Image Library
Guide on Avatar and Voice Clone
Digital Human Platform Operation Guide
Accessing Platform
Avatar Production and Asset Management
Digital Human Conversation Interaction Application and Management
Broadcast Digital Human Video Generation and Management
Operations Management and Analysis
Server API Integration
Digital Human API Access Mode Overview
Avatar aPaas API Calling Methods
Avatar Image Customization and Voice Clone API Documentation
Video Generation Service API Documentation
Interactive Digital Human Service API Documentation
Personal Asset Management API Documentation
Client SDK Integration
Overall Introduction
3D Client-Side Rendering SDK Integration
2D Client-Side Rendering SDK Integration
Digital Human SSML Markup Language Specification
Related Agreement
Privacy Policy
DSA (Data Sharing Agreement)
FAQs

Querying Timbre Lists by Pagination

PDF
Focus Mode
Font Size
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
}
}


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback