在 K 歌场景中，你可能需要根据搜索关键字来搜索歌曲。你可以使用 SearchMusics 这个 OpenAPI 来实现这一功能。

使用说明
接口行为

你可以调用 SearchMusics 接口，指定搜索关键字，搜索曲库中符合筛选条件的歌曲。

调用接口

关于调用接口的服务地址、通信协议、字符编码和签名机制，参看调用 OpenAPI。

请求说明
请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query
参数类型是否必选示例值描述
ActionString是SearchMusics接口名称。当前 API 的名称为 SearchMusics。
VersionString是2020-12-01接口版本。当前 API 的版本为 2020-12-01。
Body
参数类型是否必选示例值描述
AppIdString是Your_AppId应用的唯一标志
PageNumInteger否1分页序号，默认值为1
PageSizeInteger否10每页歌曲数量，取值范围为（0,100]，默认值为10

Filters

Array of Integer

否

1

过滤选项：

  • 1：过滤没有歌词的歌曲
  • 2：过滤不支持打分的歌曲
  • 3：过滤不支持伴唱切换的歌曲
  • 4：过滤没有高潮片段的歌曲
KeyWordString否告白气球搜索关键字。匹配优先级为：精准歌曲名匹配 -> 精准歌手名匹配 -> 歌曲名模糊匹配
返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数类型示例值描述
TotalInteger866按照搜索条件返回的歌曲总数
ListArray of MusicList返回歌曲详细信息
MusicList
参数类型示例值描述
SongIdStringYour_SongId歌曲 ID
SongnameString告白气球歌曲名称
SingerString周杰伦歌曲歌手名
VendorIdInteger1供应商 ID
VendorNameStringYour_VendorName供应商名称
PosterUrlStringhttp://www.com/xxx.jpg歌曲封面地址

LyricType

Array of Integer

歌词类型

  • 0： krc
  • 1： lrc
  • [0,1]： 两种歌词均有。
    若为空，则表示为无歌词。
DurationInteger200 歌曲时长，单位为秒

BgmType

Integer

2

歌曲是否支持伴唱原唱切换。

  • 0： 不支持。
  • 1： 声道切换
  • 2： 音轨切换

PitchType

Integer

1

歌曲是否支持打分。

  • 0： 不支持
  • 1： 支持

RecordType

Integer

1

歌曲是否支持录制。

  • 0： 不支持
  • 1： 支持
SegmentString"[65.088, 87.168]"歌曲高潮部分
UpdateAtInteger1670518801歌曲更新时间戳，unix 时间，单位为秒
LyricUrlObject of LyricUrl歌词文件地址。 建议优先使用 krc、不存在时下可选择 lrc
LyricUrl
参数类型示例值描述
KrcUrlStringhttp://www.xxx.krckrc 歌词地址
LrcUrlStringhttp://www.xxx.lrclrc 歌词地址
MidiUrlStringhttp://www.xxx.midmidi 文件地址
请求示例 
POST https://rtc.volcengineapi.com?Action=SearchMusics&Version=2020-12-01

{
    "AppId": "Your_AppId",
    "PageSize": 10,
    "PageNum": 1,
    "KeyWord": "告白气球",
    "Filters": [
        1
    ]
}

json
返回示例 
{
    "ResponseMetadata": {
        "Action": "SearchMusics",
        "Version": "2020-12-01",
        "RequestId": "Your_RequestId",
        "Region": "cn-north-1",
        "Service": "rtc"
    },
    "Result": {
        "Total": 866,
        "List": [
            {
                "SongId": "Your_SongId",
                "BgmType": 2,
                "Duration": 186,
                "LyricType": [
                    1
                ],
                "PosterUrl": "http://www.com/xxx.jpg",
                "VendorName": "Your_VendorName",
                "Singer": "周杰伦",
                "Songname": "告白气球",
                "RecordType": 1,
                "PitchType": 1,
                "UpdateAt": 1670518801,
                "Segment": "[65.088, 87.168]",
                "VendorId": 1,
                "LyricUrl": {
                    "KrcUrl": "http://www.xxx.krc",
                    "LrcUrl": "http://www.xxx.lrc",
                    "MidiUrl": "http://www.xxx.mid"
                }
            }
        ]
    }
}

json