Query Standard Timbre Paginated List

Last Updated on : 2026-07-21 08:25:24Copy for LLMView as MarkdownDownload PDF

Queries a paginated list of standard timbres.

API address

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

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	path	true	Device ID
tag	String	query	false	Timbre tag
key_word	String	query	false	Timbre name
lang	String	query	true	Language
page_no	Integer	query	true	Page number, starting from 1.
page_size	Integer	query	true	Number of items per page

Return parameter

Parameter name	Type	Description
code	Integer	The error code on failure. The value is empty on success.
success	Boolean	Indicates whether the operation is successful: `true`: success `false`:failure
msg	String	The error message on failure. The field is empty on success.
t	Long	The returned 13-digit timestamp.
result	List	The returned result.

Description of result

Parameter name	Type	Description
voice_id	String	Timbre ID
voice_name	String	Timbre name
desc_tags	List	List of description tags
support_langs	List	List of supported languages
speed	String	Default speech speed
demo_url	String	URL of the demo audio

Request example

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

Return example

{
    "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
}

Error code

For more information, see error code.

Prev DocGet Large Language Models

Next Docagent variables