---
name: "getTimbreMarketList"
mode: "api"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.0.6" }
---

## getTimbreMarketList

> [VERSION] @tuya-miniapp/cloud-api >= 1.0.6

> 💡 This API relies on cloud capabilities. Grant authorization in Development Settings - Cloud Capabilities on the [Mini App Developer Platform](https://platform.tuya.com/miniapp/).

### Description

Get paginated list of standard timbres.

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `GetTimbreMarketListParams` | Yes | Request body |

### Return Value

Type: `Promise<GetTimbreMarketListItem[]>`

GetTimbreMarketListResult (see type definitions and minituya response parameters for field meanings)

##### GetTimbreMarketListItem

| Property | Type | Description |
| --- | --- | --- |
| `voiceId` | `string` | Voice identifier |
| `voiceName` | `string` | Voice name |
| `descTags` | `string[]` | List of description tags |
| `supportLangs` | `string[]` | List of supported languages |
| `speedAdjustable` | `boolean` | Whether speed is adjustable |
| `speed` | `number` | Voice speed |
| `toneAdjustable` | `boolean` | Whether pitch is adjustable |
| `tone` | `number` | Voice pitch |
| `demoUrl` | `string` | Demo audio URL |

### Referenced Types

##### `interface` GetTimbreMarketListParams

| Property | Type | Description |
| --- | --- | --- |
| `devId` | `string` | Device ID |
| `tag` | `string` | Timbre tag |
| `keyWord` | `string` | Timbre name |
| `lang` | `string` | Language |
| `pageNo` | `number` | pageN0 |
| `pageSize` | `number` | pageSize |


### Examples

#### Request example

```typescript
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

```json
[
  {
    "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"
  }
]
```