You need to enable JavaScript to run this app.
导航

搜索音乐列表 SearchMusics

最近更新时间2024.02.29 19:30:26

首次发布时间2023.03.02 11:09:49

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

使用说明

接口行为

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

调用接口

关于调用接口的请求结构、公共参数、签名算法和返回结构,参看调用方法

请求说明

  • 请求方式:POST
  • 请求地址:https://rtc.volcengineapi.com?Action=SearchMusics&Version=2020-12-01

请求参数

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

Query

参数名称
数据类型
是否必选
示例值
描述
Action
String
SearchMusics
接口名称。当前 API 的名称为 SearchMusics
Version
String
2020-12-01
接口版本。当前 API 的版本为 2020-12-01

Body

参数
类型
是否必选
示例值
描述
AppId
String
Your_AppId
应用的唯一标志
PageNum
Integer
1
分页序号,默认值为1
PageSize
Integer
10
每页歌曲数量,取值范围为(0,100],默认值为10
Filters
Integer[]
1

过滤选项:

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

返回参数

下表仅列出本接口特有的返回参数,公共返回参数请参见返回结构

参数
类型
示例值
描述
Total
Integer
866
按照搜索条件返回的歌曲总数
List
Object[]
返回歌曲详细信息
SongId
String
Your_SongId
歌曲 ID
Songname
String
告白气球
歌曲名称
Singer
String
周杰伦
歌曲歌手名
VendorId
Integer
1
供应商 ID
VendorName
String
Your_VendorName
供应商名称
PosterUrl
String
http://www.com/xxx.jpg
歌曲封面地址
LyricType
Integer[]

歌词类型

  • 0krc
  • 1lrc
  • [0,1]: 两种歌词均有。
    若为空,则表示为无歌词。
Duration
Integer
200
歌曲时长,单位为秒
BgmType
Integer
2

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

  • 0: 不支持。
  • 1: 声道切换
  • 2: 音轨切换
PitchType
Integer
1

歌曲是否支持打分。

  • 0: 不支持
  • 1: 支持
RecordType
Integer
1

歌曲是否支持录制。

  • 0: 不支持
  • 1: 支持
Segment
String
"[65.088, 87.168]"
歌曲高潮部分
UpdateAt
Integer
1670518801
歌曲更新时间戳,unix 时间,单位为秒
LyricUrl
Object
歌词文件地址。 建议优先使用 krc、不存在时下可选择 lrc
KrcUrl
String
http://www.xxx.krc
krc 歌词地址
LrcUrl
String
http://www.xxx.lrc
lrc 歌词地址
MidiUrl
String
http://www.xxx.mid
midi 文件地址

请求示例

POST https://rtc.volcengineapi.com?Action=SearchMusics&Version=2020-12-01

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

返回示例

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