内容资源列表API

更新时间：2026-07-10

内容资源列表

接口描述

内容资源查询 (list)，可以根据资源名称、专辑名称、资源id、歌手、资源类别查询相关内容资源

权限说明

该API的安全认证一律采用Access Key与请求签名机制。鉴权认证机制的详细内容请参见鉴权认证

请求语法

                JSON
                
                POST /api/v{version}/content/data/content/list HTTP/1.1
host: rtc-aiagent.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名	类型	是否必填	描述
page	int	否	页数，默认值为1
pageSize	int	否	每页数量，默认值为20
name	String	否	资源名称
albumName	String	否	专辑名称
albumArtist	String	否	歌手
trackId	String	否	资源id
categoryName	String	否	类别 (音乐、儿童、小说、戏曲、评书、相声、资讯、其他、人文、广播剧、故事、白噪声)
format	String	否	内容资源格式（mp3、m4a）
updateStartTime	String	否	查询资源更新开始时间（UTC），最早时间：2026-05-16T00:00:00Z，格式要求：yyyy-mm-ddTHH:mm:ssZ
updateEndTime	String	否	查询资源更新结束时间（UTC），格式要求：yyyy-mm-ddTHH:mm:ssZ

请求示例

                JSON
                
            

                POST /api/v1/content/data/content/list  HTTP/1.1
host: rtc-aiagent.baidubce.com
content-type: application/json
authorization: {bce-authorization-string}
x-bce-request-id: {bce-request-id}

{
    "page":5,
    "pageSize": 2,
    "name":"儿歌",
    "albumName":"",
    "albumArtist":"",
    "trackId":"",
    "albumId":"",
    "categoryName":"",
    "format":"m4a",
    "updateStartTime":"",
    "updateEndTime":""
}
            

响应参数

参数名	类型	描述
page	int	页数
pageSize	int	每页数量
total	long	符合条件的资源数量
list	List	查询结果
\|─	object
\|─trackId	String	内容资源id
\|─name	String	内容资源名称
\|─albumId	String	专辑id
\|─albumName	String	专辑名称
\|─albumArtist	String	歌手/作者
\|─categoryName	String	类别
\|─available	boolean	当前资源是否可用
\|─format	String	内容资源格式
\|─updatedTime	Timestamp	资源更新时间
\|─coverUrl	String	图片信息
\|─mediaLength	int	资源时长

响应示例

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 05 Sep 2025 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
    "page": 5,
    "pageSize": 2,
    "total": 250,
    "list": [
        {
            "trackId": "testTrackId1",
            "name": "少儿歌曲1",
            "albumId": "testAlbumId1",
            "albumName": "少儿歌手推荐歌曲",
            "albumArtist": "歌手1",
            "categoryName": "儿童",
            "episode": "第*集",
            "available": true,
            "format": "m4a",
            "updatedTime": "2026-05-12T19:30:55.000+00:00",
            "coverUrl": "{\"small\":\"http://********\",\"middle\":\"http://********\",\"large\":\"http://*********\"}",
            "mediaLength": 176000
        },
        {
            "trackId": "testTrackId2",
            "name": "少儿歌曲2",
            "albumId": "testAlbumId2",
            "albumName": "少儿歌手推荐歌曲",
            "albumArtist": "歌手2",
            "categoryName": "儿童",
            "episode": "第*集",
            "available": true,
            "format": "m4a",
            "updatedTime": "2026-05-12T19:30:55.000+00:00",
            "coverUrl": "{\"small\":\"http://********\",\"middle\":\"\",\"large\":\"\"}"
        },
        "mediaLength": 187000
    ]
}
            

根据类别获取专辑列表

接口描述

指定类别，获取对应类别的专辑列表，其中类别包括一级分类和二级分类，分类标签参见 (分类标签参见一级分类标签、二级分类标签。

权限说明

该API的安全认证一律采用Access Key与请求签名机制。鉴权认证机制的详细内容请参见鉴权认证

请求语法

                JSON
                
                GET /api/v{version}/contents/albums HTTP/1.1
host: rtc-aiagent.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名	类型	是否必填	描述
pageNo	int	否	页数，默认值为1
pageSize	int	否	每页数量，默认值为20，最大值为100
category	String	是	一级分类，取值范围：音乐、儿童、小说、戏曲、评书、相声、资讯、其他、人文、广播剧、故事、白噪声
tag	String	否	二级分类，取之范围：参见二级分类标签

请求示例

                JSON
                
            

                GET /api/v1/contents/albums?category=儿童&tag=儿歌&pageNo=1&pageSize=2  HTTP/1.1
host: rtc-aiagent.baidubce.com
content-type: application/json
authorization: {bce-authorization-string}
x-bce-request-id: {bce-request-id}
            

响应参数

参数名	类型	描述
pageNo	int	页数
pageSize	int	每页数量
totalCount	int	符合条件的专辑数量
data	List	查询结果

响应示例

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 01 June 2026 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
    "pageNo": 3,
    "pageSize": 2,
    "data": [
        {
            "albumId": "1234****9",
            "albumName": "album1",
            "categoryName": "儿童",
            "coverImgUrl": "{\"small\": \"http://*****\", \"middle\": \"http://****\", \"large\": \"***\"}",
            "num": 10,
            "albumIntro": "儿歌大集合1",
            "albumArtist": "****",
            "totalTime": 8583000,
            "tag": "儿歌"
        },
        {
            "albumId": "1234****8",
            "albumName": "album2",
            "categoryName": "儿童",
            "coverImgUrl": "{\"small\": \"http://*****\", \"middle\": \"http://****\", \"large\": \"***\"}",
            "num": 10,
            "albumIntro": "儿歌大集合2",
            "albumArtist": "****",
            "totalTime": 9876000,
            "tag": "儿歌"
        }
    ],
    "totalCount": 666
}
            

一级分类标签

音乐、儿童、小说、戏曲、评书、相声、资讯、其他、人文、广播剧、故事、白噪声

二级分类标签

一级分类	二级分类
儿童	其他
儿童	童话故事
儿童	科普百科
儿童	睡前故事
儿童	国学启蒙
儿童	绘本故事
儿童	寓言成语故事
儿童	成长
儿童	古诗词启蒙
儿童	儿歌
小说	其他
小说	言情甜宠
小说	穿越重生
小说	都市现实
小说	古代
小说	悬疑灵异惊悚
小说	玄幻武侠
小说	军事谍战
小说	历史架空
戏曲	名家荟萃
戏曲	地方戏
戏曲	其他
戏曲	京剧
戏曲	豫剧
戏曲	越剧
戏曲	昆曲
戏曲	秦腔
戏曲	评剧
戏曲	川剧
评书	其他
评书	名著改编
评书	历史演义
评书	武侠公案
评书	神话志怪
评书	民间故事
评书	人物传记
评书	现代
评书	粤语评书
相声	各地相声社团
相声	对口相声
相声	名家经典
相声	其他
相声	相声专场
相声	校园相声
相声	小品喜剧
相声	口才训练
相声	群口相声
资讯	其他
资讯	交通电台
资讯	汽车
资讯	汽车脱口秀
资讯	汽车文化
资讯	自驾旅行
资讯	赛车
其他	相声曲艺
其他	健康养生
其他	生活访谈
其他	其他
其他	国学哲学
人文	儒家思想
人文	国学经典
人文	哲学
人文	读书
人文	道家思想
人文	儒释道融合
人文	其他
广播剧	言情广播剧
广播剧	其他
广播剧	社团广播剧
广播剧	玄幻广播剧
广播剧	现代广播剧
故事	心理疗愈
故事	情感故事
故事	有声读物
故事	其他
白噪声	助眠自然音
白噪声	冥想疗愈
历史	中国思想史

评价此篇文章

有帮助没帮助

主动任务管理

原子能力-图片生成

百度智能云

RTC 实时音视频

RTC 实时音视频

内容资源列表API

内容资源列表

接口描述

权限说明

请求语法

请求头域

请求参数

请求示例

响应参数

响应示例

根据类别获取专辑列表

接口描述

权限说明

请求语法

请求头域

请求参数

请求示例

响应参数

响应示例

一级分类标签

二级分类标签