Get Music Resource List

Last Updated on : 2026-04-15 02:31:50Copy for LLMView as MarkdownDownload PDF

Retrieve music resources in the file box easily. This aims to help users quickly access and manage music files stored in the file box, so as to enjoy a rich variety of music content.

API address

POST: /v1.0/cloud/agent/file/box/user/list/search

Request parameter

Description of body

Parameter name	Type	IN	Required	Description
params	String	body	true	The JSON parameters.
tag	List	params	true	The tag.
textWeight	Double	params	false	The scalar rating weight.
vectorWeight	Double	params	false	The vector rating weight.
topK	Integer	params	false	The quantity of top-scoring results to return.
filterScore	Double	params	false	Optional minimum score threshold.
searchTagCondition	List	params	false	The file type.

Description of searchTagCondition

Parameter name	Type	IN	Required	Description
key	String	searchTagCondition	true	The profile properties.
value	String	searchTagCondition	true	The file property value.

Description of tag

Parameter name	Type	IN	Required	Description
key	String	tag	true	The tag key.
value	String	tag	true	The tag value.

Return parameter

Parameter name	Type	Description
result	List	The returned result.

Request example

POST: /v1.0/cloud/agent/file/box/user/list/search

{
  "params": "{\"tag\":[[{\"key\":\"color\",\"value\":\"red\"},{\"key\":\"style\",\"value\":\"modern\"}]],\"searchTag\":[{\"key\":\"lang\",\"value\":\"zh\"},{\"key\":\"format\",\"value\":\"mp4\"}],\"textWeight\":0.5,\"vectorWeight\":0.5,\"topK\":10,\"filterScore\":0.6}"
}

Return example

{
    "result": [
        {
            "fileTime": "120",
            "objectStatus": "1",
            "format": "mp4",
            "downloadUrl": "https://example.com/files/product_intro.mp4",
            "bitrate": "3000",
            "uploadTime": 1712736000000,
            "size": "15728640",
            "objectKey": "obj_001",
            "objectName": "product_intro.mp4",
            "tag": [
                {
                    "value": "red",
                    "key": "color"
                },
                {
                    "value": "modern",
                    "key": "style"
                }
            ],
            "lang": "zh"
        },
        {
            "fileTime": "300",
            "objectStatus": "1",
            "format": "mp3",
            "downloadUrl": "https://example.com/files/user_guide.mp3",
            "bitrate": "128",
            "uploadTime": 1712649600000,
            "size": "5242880",
            "objectKey": "obj_002",
            "objectName": "user_guide.mp3",
            "tag": [
                {
                    "value": "classic",
                    "key": "style"
                }
            ],
            "lang": "en"
        }
    ],
    "success": true
}

Error code

For more information, see error code.

Prev DocGet File Box Tags

Next DocBatch Data Retrieval