内容资源私有库API

更新时间：2026-02-05

创建私有库

接口描述

创建私有库（注意，限制最多创建5个）

请求语法

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

请求头域

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

请求参数

无

请求示例

                JSON
                
            

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

响应参数

参数名	类型	描述
result	String	操作结果
dbName	String	私有库名

响应示例

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 05 Sep 2022 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
    "result": "success",
    "dbName": "content-1111"
}
            

删除私有库

接口描述

删除私有库

请求语法

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

请求头域

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

请求参数

参数名	类型	是否必填	描述
dbName	String	是	私有库名称

请求示例

                JSON
                
            

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

{
  "dbName": "content-1111"
}
            

响应参数

参数名	类型	描述
result	String	操作结果

响应示例

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 05 Sep 2022 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
    "result": "success"
}
            

查询私有库

接口描述

查询私有库列表

请求语法

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

请求头域

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

请求参数

无

请求示例

                JSON
                
            

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

响应参数

参数名	类型	描述
result	String	操作结果
total	Integer	数据量
data	List	数据列表
\|─	object
\|─createTime	String	UTC创建时间 "2026-01-01T00:00:00Z"
\|─dbName	String	资源库名称

响应示例

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 05 Sep 2022 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
   "result":"success",
   "total":1,
   "data": [
        {
            "createTime": "",
            "dbName": ""
        }
    ]
}
            

内容资源新增

接口描述

私有库新增内容资源数据

请求语法

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

请求头域

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

请求参数

参数名	类型	是否必填	描述
dbName	String	是	数据库
dataList	List		数据列表
\|─	object
\|─track_id	String	是	内容资源id（同一个库内需要保持不重复）
\|─name	String	是	内容资源名称
\|─album_name	String	是	专辑名称
\|─album_id	String	否	专辑id
\|─album_artist	String	否	歌手/作者
\|─category_name	String	否	类型（如，儿童、流行）
\|─album_intro	String	否	专辑介绍
\|─source	String	否	来源
\|─episode	String	否	集数（用于故事集、相声集）
\|─play_link_url	String	是	播放链接
\|─cover_url	Object	否	歌曲图片
\|─\|─small	String	否	小图片
\|─\|─middle	String	否	中图片
\|─\|─large	String	否	大图片

请求示例

                JSON
                
            

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

{
  "dbName": "",
  "dataList": [
    {
      "track_id": "",
      "name": "",
      "album_name": "",
      "album_id": "",
      "album_artist": "",
      "category_name": "",
      "album_intro": "",
      "source": "",
      "episode": "",
      "play_link_url": "",
      "cover_url": {
        "small":"",
        "middle":"",
        "large":""
      }
    }
  ]
}
            

响应参数

参数名	类型	描述
result	String	操作结果

响应示例

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 05 Sep 2022 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
  "result": ""
}
            

内容资源删除

接口描述

删除私有库内容资源数据

请求语法

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

请求头域

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

请求参数

参数名	类型	是否必填	描述
dbName	String	是	私有库名称
dataList	array	是	要删除的trackId列表（单次最多500个）

请求示例

                JSON
                
            

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

{
  "dbName": "content-1111",
  "dataList":["id-1111","id-2222"]
}
            

响应参数

参数名	类型	描述
result	String	操作结果

响应示例

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 05 Sep 2022 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
  "result": ""
}
            

内容资源查询

接口描述

私有库内容资源查询（list）

请求语法

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

请求头域

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

请求参数

参数名	类型	是否必填	描述
dbName	String	是	数据库名称
cusor	String	否	查询起始位置（trackId）,查询游标后的数据；默认为空，空值默认从头查询
limit	Interge	否	返回数量（最大值为500，默认为50）
name	String	否	资源名称
albumName	String	否	查询专辑名称
albumArtist	String	否	查询专辑作者
trackId	String	否	资源id

请求示例

                JSON
                
            

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

{
    "dbName":"",
    "limit": 10,
    "cursor":"",
    "name":"",
    "albumName":"",
    "albumArtist":"",
    "trackId":""
}
            

响应参数

参数名	类型	描述
result	String	操作结果
total	Integer	数据量
cusor	String	下次查询的起始位置（trackId）,查询游标后的数据
data	List	操作结果
\|─	object
\|─track_id	String	是
\|─name	String	是
\|─album_name	String	是
\|─album_id	String	否
\|─album_artist	String	否
\|─category_name	String	否
\|─album_intro	String	否
\|─source	String	否
\|─episode	String	否
\|─play_link_url	String	是
\|─cover_url	Object	否
\|─\|─small	String	否
\|─\|─middle	String	否
\|─\|─large	String	否

响应示例

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 05 Sep 2022 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
    "result": "success",
    "total": 26,    
    "data": [
        {
            "album_artist": "",
            "album_id": "",
            "album_intro": "",
            "album_name": "",
            "category_name": "",
            "episode": "",
            "id": "",
            "if_used": true,
            "name": "",
            "play_link_url": "",
            "source": "",
            "track_id": "",
            "cover_url": "cover_url": {
                "small":"",
                "middle":"",
                "large":""
             }
        }
    ],
    "cursor": "" 
}
            

内容资源统计

接口描述

私有库数据统计

请求语法

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

请求头域

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

请求参数

参数名	类型	是否必填	描述
dbName	string	是

请求示例

                JSON
                
            

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

{
  "dbName": ""
}
            

响应参数

参数名	类型	描述
count	Integer	数据量

响应示例

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
date: Mon, 05 Sep 2022 03:25:43 GMT
transfer-encoding: chunked
content-type: application/json;charset=UTF-8
cache-control: no-cache
{
    "count": 0
}
            

C端复刻接口

客户端SDK

RTC 实时音视频

内容资源私有库API

创建私有库

接口描述

请求语法

请求头域

请求参数

请求示例

响应参数

响应示例

删除私有库

接口描述

请求语法

请求头域

请求参数

请求示例

响应参数

响应示例

查询私有库

接口描述

请求语法

请求头域

请求参数

请求示例

响应参数

响应示例

内容资源新增

接口描述

请求语法

请求头域

请求参数

请求示例

响应参数

响应示例

内容资源删除

接口描述

请求语法

请求头域

请求参数

请求示例

响应参数

响应示例

内容资源查询

接口描述

请求语法

请求头域

请求参数

请求示例

响应参数

响应示例

内容资源统计

接口描述

请求语法

请求头域

请求参数

请求示例

响应参数

响应示例