getTimbreMarketList(params: GetTimbreMarketListParams)

Requires:
@tuya-miniapp/cloud-api≥1.0.6

Description

Get paginated list of standard timbres.

Parameters

ParameterTypeRequiredDescription
YesRequest body

Return Value

Type: Promise<GetTimbreMarketListResult>
GetTimbreMarketListResult (see type definitions and minituya response parameters for field meanings)

Referenced Types

typeGetTimbreMarketListResult
CommonPageResult<GetTimbreMarketListItem>

Examples

Request example

import { getTimbreMarketList } from '@tuya-miniapp/cloud-api';

const params = {
  devId: 'your_device_id',
  tag: 'gentle',
  keyWord: 'gentle',
  lang: 'zh-CN',
  pageNo: 1,
  pageSize: 10,
};

getTimbreMarketList(params)
  .then(result => {
    console.log('Timbre list:', result);
  })
  .catch(error => {
    console.error('Failed to get timbre list:', error);
  });

Response example

{
  "page": 1,
  "pageSize": 10,
  "totalPage": 1,
  "total": 1,
  "list": [
    {
      "voiceId": "voice_001",
      "voiceName": "Gentle female voice",
      "descTags": [
        "Gentle",
        "Sweet",
        "Professional"
      ],
      "supportLangs": [
        "zh-CN",
        "en-US"
      ],
      "speedAdjustable": true,
      "speed": 1,
      "toneAdjustable": true,
      "tone": 0.8,
      "demoUrl": "https://example.com/demo_voice.mp3"
    }
  ]
}