查询标准音色分页列表

更新时间：2026-07-21 08:25:22LLM 副本以 Markdown 格式查看下载 PDF

本文介绍查询标准音色分页列表的 API。

接口描述

分页查询标准音色列表。

接口地址

GET: /v1.0/cloud/agent/ai/timbre/b/devices/{device_id}/market-timbres

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID
tag	String	query	false	音色标签
key_word	String	query	false	音色名称
lang	String	query	true	语言
page_no	Integer	query	true	页码，从 1 开始
page_size	Integer	query	true	每页数量

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功： `true`：成功 `false`：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	List	返回结果

result 说明

参数名	类型	说明
voice_id	String	音色 ID
voice_name	String	音色名称
desc_tags	List	描述标签列表
support_langs	List	支持的语种列表
speed	String	默认语速
demo_url	String	示范音频的 URL

请求示例

GET: /v1.0/cloud/agent/ai/timbre/b/devices/abc123/market-timbres?tag=gentle&key_word=Alice&lang=en&page_no=1&page_size=20

{
  "path": {
    "device_id": "abc123"
  },
  "query": {
    "tag": "gentle",
    "key_word": "Alice",
    "lang": "en",
    "page_no": 1,
    "page_size": 20
  }
}

返回示例

{
    "msg": null,
    "code": null,
    "result": [
        {
            "voice_id": "voice_001",
            "demo_url": "https://example.com/demo.mp3",
            "support_langs": [
                "en",
                "zh"
            ],
            "voice_name": "Alice",
            "speed": "1.0",
            "desc_tags": [
                "gentle",
                "warm"
            ]
        }
    ],
    "t": 1573441137000,
    "success": true
}

错误码

参考错误码。

上一篇获取支持的大模型列表

下一篇智能体变量