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

## getTimbreMarketList

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

> 💡 接口依赖云能力，需在 [小程序开发者平台](https://platform.tuya.com/miniapp/)开发设置 - 云能力 进行授权配置。

### 描述

获取标准音色分页列表。

### 参数

`Params`

| 参数 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `params` | `GetTimbreMarketListParams` | 是 | - | 请求体 |

### 引用对象

##### `interface` GetTimbreMarketListParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备ID |
| `tag` | `string` | 音色标签 |
| `keyWord` | `string` | 音色名称 |
| `lang` | `string` | 语言 |
| `pageNo` | `number` | pageN0 |
| `pageSize` | `number` | pageSize |


### 示例代码

#### 请求示例

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

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

getTimbreMarketList(params)
  .then(result => {
    console.log('音色列表:', result);
  })
  .catch(error => {
    console.error('获取音色列表失败:', error);
  });
```

#### 返回示例

```json
[
  {
    "voiceId": "voice_001",
    "voiceName": "温柔女声",
    "descTags": [
      "温柔",
      "甜美",
      "专业"
    ],
    "supportLangs": [
      "zh-CN",
      "en-US"
    ],
    "speedAdjustable": true,
    "speed": 1,
    "toneAdjustable": true,
    "tone": 0.8,
    "demoUrl": "https://example.com/demo_voice.mp3"
  }
]
```