# 歌曲信息接口
# 接口描述
通过歌曲 TSID 查询歌曲的信息。信息包括:
- 歌曲基本信息:名称、歌曲艺人、歌曲所属专辑、歌曲封面、歌词、发行时间、曲风标签
- 歌曲音频信息:音频支持码率、伴奏音频信息、试听音频信息
- 歌曲授权信息:会员/数字音乐标识、授权时间
因歌曲数量庞大,不一定包含以上所有的信息,此时值为空,这种现象一般在冷门歌曲上可能遇到。
歌曲信息表
歌曲信息 | 说明 |
---|---|
歌曲艺人 | 提供歌曲的表演者艺人,其职业为歌手 |
歌曲封面 | 提供原始封面尺寸路径,在使用中请按需进行切图 |
歌词 | 支持格式有:lrc、txt,优先提供 lrc 歌词。伴奏音频有 krc 逐字歌词。没有歌词时为空 |
曲风标签 | 提供歌曲的风格标签信息,如流行 |
音频信息 | 包括:64 kbps,aac 格式;128kbps,mp3 格式;320kbps,mp3 格式;无损,flac 格式。具体根据合作的码率提供相应范围的音频 |
伴奏信息 | 伴奏规格同正常音频,有伴奏的音频可查询到此项信息 |
短音频 | 此接口无法直接查询短音频,需要在接口进行查询 |
试听信息 | 当 pay_model 值为 3 时,提供 trail_audio_info 信息,可直接使用此播放链接进行试听,其中提供的时长和开始时间用于做音轨的锚点定位 |
# 调用地址
请求地址:/SONG/trackInfo.json
调用方法:POST
# 输入参数
参数名 | 类型 | 是否必传 | 说明 |
---|---|---|---|
TSID | string | 必传 | 传值歌曲 TSID 编码,如 T10040589078。可以同时查询多个歌曲的信息,用,分割,最多一次查询 100 条 |
# 返回结果
{
"state": true,
"errcode": "",
"errmsg": "",
"data": [
{
"artist": [
{
"artistCode": "A10047720",
"birthday": "1983-07-17",
"gender": "男",
"name": "薛之谦",
"artistType": 38,
"artistTypeName": "歌手",
"pic": "https://img01.dmhmusic.com/0101/M00/F8/AE/ChR45V7XEJWAZJ8KAAL8wj6aS4w115.jpg",
"region": ""
}
],
"cpId": 23,
"pic": "https://img01.dmhmusic.com/0102/M00/FB/D2/ChR45F7zhz6AAmQ0ABfwN8oS_sw095.jpg",
"title": "摩天大楼",
"duration": 230,
"assetId": "T10044298014",
"genre": "流行",
"albumTitle": "摩天大楼",
"id": "T10044298014",
"lang": "中文",
"afReplayGain": -1.300003,
"albumAssetCode": "P10002077754",
"releaseDate": "2018-04-18T00:00:00.000Z",
"isrc": "CN-Z50-18-00330",
"sort": 1,
"meanVolume": -14.8,
"maxVolume": 0,
"lyric": "https://static01.dmhmusic.com/0101/M00/10/C5/ChR45V8ieY-AWXArAAAILwwOB7c212.lrc",
"pay_model": 1,
"TSID": "T10044298014",
"allRate": ["3000", "64", "320", "128"],
"pushTime": "2019-03-05T16:43:14+08:00",
"downTime": "2037-01-01T00:00:00+08:00",
"bizList": ["sdk_cpm"],
"rateFileInfo": {
"64": {
"size": 1844408,
"format": "aac"
},
"128": {
"size": 3688951,
"format": "mp3"
},
"320": {
"size": 9222313,
"format": "mp3"
},
"3000": {
"size": 20263769,
"format": "flac"
}
},
"backing": []
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63