tencent cloud

Feedback

Querying Timbre Lists by Pagination

Last updated: 2024-07-19 10:18:08
    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

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

    Response Parameter

    Parameters
    Type
    Mandatory
    Description
    TimbreAssets
    Array of [TimbreAssetDetail]
    Yes
    Timbre Asset Information
    Total
    int
    Yes
    Totals
    TimbreAssetDetail
    Parameters
    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

    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
    }
    }
    
    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 avaliable.

    7x24 Phone Support