获取音乐资源列表

更新时间：2026-04-15 02:31:47LLM 副本以 Markdown 格式查看下载 PDF

本文介绍获取音乐资源列表的 API。

接口描述

轻松检索文件盒子中的所有音乐资源。该功能旨在帮助用户快速访问和管理存储在文件盒子中的音乐文件，以畅享丰富的音乐内容。

接口地址

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

请求参数

body 说明

参数名	类型	参数位置	是否必填	说明
params	String	body	true	JSON 参数
tag	List	params	true	标签
textWeight	Double	params	false	标量评分权重
vectorWeight	Double	params	false	向量得分权重
topK	Integer	params	false	要返回的得分最高的结果数量
filterScore	Double	params	false	可选的最低分数阈值
searchTagCondition	List	params	false	业务的文件类型

searchTagCondition 说明

参数名	类型	参数位置	是否必填	说明
key	String	searchTagCondition	true	文件属性
value	String	searchTagCondition	true	文件属性 Value

tag 说明

参数名	类型	参数位置	是否必填	说明
key	String	tag	true	标签 Key
value	String	tag	true	标签 Value

返回参数

参数名	类型	说明
result	List	返回结果

请求示例

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

返回示例

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

错误码

参考错误码。

上一篇获取文件盒子标签

下一篇批量获取数据