前言#

警告

本教程仅供学习交流，下载的音乐文件请于24小时内删除。

请务必尊重正版，从正常渠道获取音乐资源。

造成的法律问题请自行承担责任。

提示
教程中的酷狗主要指的是酷狗概念版，并非酷狗官方版。

由于某些原因，我们有时需要下载一些歌曲。
如果是非VIP歌曲（即无需开通会员即可听完整首歌、下载需要会员），可以直接去到酷狗音乐官网对应的歌曲页，从 Dev Tools 中获取128kbps、.mp3歌曲的链接： kugou-music-web-1

并且，从这个链接获取的是音乐源文件，也就是说包含了歌手等数据： kugou-music-example-details

但是，对于一些VIP歌曲（即无会员时仅可试听），即使购买了会员，一般情况下，在酷狗概念版下载VIP歌曲获得的是类似 xxx.kgm.flac 格式的文件。上锁了。
这种文件直接访问 https://legacy.um-react.app ，解锁一下音乐就好了。

这依然很麻烦。需要先将 xxx.kgm.flac 重命名为 xxx.kgm 后才能解锁，对于手机来说总体步骤比较麻烦，且

一次性解锁一堆文件需要先传输到电脑再一并解锁。
酷狗概念版没有 PC 端。
畅听 VIP 无法下载 VIP 歌曲。参见 #两种VIP的不同点。
免费的酷狗概念版 VIP 从 API 获取最快。

用开源酷狗API解析音乐文件URL#

后端#

注意

请不要信任陌生的后端 API 地址，以免造成数据泄露

调用时要加上**&和随机的字符**，以免后端缓存结果。

需要将环境变量 platform 改为 lite（概念版）。参见 https://github.com/MakcRe/KuGouMusicApi#使用接口为概念版

MakcRe

KuGouMusicApi

Waiting for api.github.com...

00K

Waiting...

可将这个 NodeJS 版酷狗 API 的后端搭建在 Vercel 上调用（记得关注 Usage 使用情况）。也可以下载到本地安装依赖然后

1
npm install
2
set platform=lite
3
npm run dev

总之，搭建成功后的后端服务器的根目录应为：

官方 API 文档： https://kugoumusicapi-docs.4everland.app/#/

接下来将以 kugou.cl.nz 作为演示，可以直接在浏览器输入。实际使用请替换为自己的。

第一步：登录#

https://kugoumusicapi-docs.4everland.app/#/?id=登录
 https://kugoumusicapi-docs.4everland.app/#/?id=发送验证码

手机号登录（推荐）：

1
# 发送验证码到 12345678910
2
https://kugou.cl.nz/captcha/sent?mobile=12345678910&qwertyuiop
3

4
#填入获得的验证码
5
https://kugou.cl.nz/login/cellphone?mobile=12345678910&code=114514&qwertyuiop

成功后将会显示个人信息。

第二步：领取VIP#

https://kugoumusicapi-docs.4everland.app/#/?id=领取-vip（需要登陆，该接口为测试接口仅限概念版使用

1
# 需要登录。领取概念版VIP，一次增加三小时，可重复获取8次，最大24h
2
https://kugou.cl.nz/youth/vip?qwertyuiop
3

4
领取完毕后为 {"error_msg":"今天次数已用光","data":"","status":0,"error_code":30002}

第三步：搜索音乐#

https://kugoumusicapi-docs.4everland.app/#/?id=综合搜索

目的是为了获取音乐哈希值 FileHash。如果有 FileHash 的话可以直接前往 #第四步：下载音乐

1
# 无需登录。无需取消缓存。返回 JSON。
2
# 可以搜歌词，也可以输入完整的音乐名，和在客户端搜索基本一致。一般大众音乐排在第一位。
3
# 以搜索歌词为例，源歌曲为 ARI HICKS - Kiss Me, Kill Me：So Tell Me What You're Waiting For
4
https://kugou.cl.nz/search/complex?keywords=So%20Tell%20Me%20What%20You%27re%20Waiting%20For

将会返回：

1
{
2
  "data": {
3
    "correctiontip": "",
4
    "correctionforce": 0,
5
    "lists": [
39 collapsed lines
6
      {
7
        "allowerr": 0,
8
        "isshareresult": 0,
9
        "sectag_info": {
10
          "is_sectag": 0
11
        },
12
        "istagresult": 0,
13
        "total": 42,
14
        "istag": 0,
15
        "lists": [
16
          {
17
            "SQFileHash": "243D9A6F6918879FAD2DAD37570B0FE3",
18
            "PublishTime": "",
19
            "Audioid": 83208546,
20
            "SuperDuration": 0,
21
            "OldCpy": 0,
22
            "PublishAge": 255,
23
            "HQBitrate": 320,
24
            "PayType": 3,
25
            "TagContent": "评论过万",
26
            "Accompany": 1,
27
            "SingerName": "ARI HICKS", // 歌手名
28
            "HQPrivilege": 10,
29
            "TopicRemark": "",
30
            "OriOtherName": "",
31
            "ShowingFlag": 0,
32
            "Source": "",
33
            "SQFileSize": 22060693,
34
            "AlbumAux": "",
35
            "HQDuration": 182,
36
            "Image": "http://imge.kugou.com/stdmusic/{size}/20221103/20221103054712785952.jpg",
37
            "HQPayType": 3,
38
            "HeatLevel": 5,
39
            "M4aSize": 0,
40
            "trans_param": {
41
              "ogg_128_hash": "A38E084A07325BCD0DD037F8145FA349",
42
              "classmap": {
43
                "attr0": 234881032
44
              },
45
              "language": "英语",
46
              "cpy_attr0": 58735744,
33 collapsed lines
47
              "musicpack_advance": 1,
48
              "ogg_128_filesize": 2229498,
49
              "display_rate": 0,
50
              "union_cover": "http://imge.kugou.com/stdmusic/{size}/20221103/20221103054712785952.jpg",
51
              "qualitymap": {
52
                "attr0": 2134884468,
53
                "attr1": 136511488
54
              },
55
              "ogg_320_filesize": 8233880,
56
              "ogg_320_hash": "215E60CC931F0D02115735C082DCF590",
57
              "cid": 116911077,
58
              "cpy_grade": 5,
59
              "display": 0,
60
              "ipmap": {
61
                "attr0": 8606716928
62
              },
63
              "hash_offset": {
64
                "clip_hash": "9D099E09E3C7F057019305F0775A3ABA",
65
                "start_byte": 0,
66
                "end_ms": 60000,
67
                "end_byte": 960181,
68
                "file_type": 0,
69
                "start_ms": 0,
70
                "offset_hash": "87DB3C1A71394DD3D96BDF08E9477790"
71
              },
72
              "hash_multitrack": "8849F7DF7102CC5973C665C130EB2AED",
73
              "pay_block_tpl": 1,
74
              "cpy_level": 1
75
            },
76
            "SQPkgPrice": 1,
77
            "UploaderContent": "",
78
            "FoldType": 0,
79
            "FileSize": 2925136,
80
            "IsOriginal": 1, // 是否为原版，1为原版
81
            "FileHash": "0FD4158049ABCF692DA7E4D1C1AA963A", // 音乐哈希
82
            "Grp": [],
83
            "ID": "276107671",
10 collapsed lines
84
            "isPrepublish": 0,
85
            "MvTrac": 3,
86
            "vvid": "",
87
            "Type": "audio",
88
            "Bitrate": 128,
89
            "SQPrice": 200,
90
            "ASQPrivilege": 10,
91
            "ExtName": "mp3",
92
            "PkgPrice": 1,
93
            "AlbumPrivilege": 10,
94
            "AlbumID": "39450255",
95
            "AlbumName": "Kiss Me, Kill Me",
10 collapsed lines
96
            "Category": 1,
97
            "SuperExtName": "",
98
            "mvdata": [
99
              {
100
                "typ": 0,
101
                "trk": "3",
102
                "hash": "CAC0D33EE16A332FD8B2F8C3FB243856",
103
                "id": "10184904"
104
              }
105
            ],
106
            "OtherName": "",
107
            "SongName": "Kiss Me, Kill Me",
11 collapsed lines
108
            "Res": {
109
              "PkgPrice": 1,
110
              "Privilege": 10,
111
              "PayType": 3,
112
              "Price": 200,
113
              "FailProcess": 4
114
            },
115
            "AudioCdn": 0,
116
            "SourceID": 0,
117
            "SQDuration": 182,
118
            "HQFileSize": 7312454,
119
            "MixSongID": "276107671",
120
            "Singers": [
121
              {
122
                "name": "ARI HICKS",
123
                "ip_id": 0,
124
                "id": 7279057
125
              }
126
            ],
51 collapsed lines
127
            "SQPayType": 3,
128
            "SuperBitrate": 0,
129
            "MvHash": "CAC0D33EE16A332FD8B2F8C3FB243856",
130
            "HQPrice": 200,
131
            "Suffix": "",
132
            "HQFailProcess": 4,
133
            "HasAlbum": 1,
134
            "ResDuration": 182,
135
            "ResBitrate": 1670,
136
            "HiFiQuality": 3,
137
            "ResFileHash": "CD2CB994A5D61FABA86F258731CECF5E",
138
            "SingerId": [7279057],
139
            "HQExtName": "mp3",
140
            "SongLabel": "",
141
            "MatchFlag": 65536,
142
            "Scid": 83208546,
143
            "SuperFileHash": "",
144
            "QualityLevel": 3,
145
            "OriSongName": "Kiss Me, Kill Me", // 原始音乐名
146
            "MvType": 2,
147
            "mvTotal": 0,
148
            "SuperFileSize": 0,
149
            "FailProcess": 4,
150
            "SQExtName": "flac",
151
            "SQBitrate": 965,
152
            "RankId": 0,
153
            "PublishDate": "2020-10-30",
154
            "HQFileHash": "639FC7A5F9B7DA787D546B97BCA83BE6",
155
            "TopicUrl": "",
156
            "Auxiliary": "歌词 : So tell me what you're waiting for Don't you wanna be the one who stays alive A feeling that you can't ignore Me creeping up inside Oh why do I love a little bit of kiss me kill me cry Oh I oh I love a little bit of kiss me kill me die ", // 搜索中关键词的来源
157
            "TagDetails": [
158
              {
159
                "content": "评论过万", // 标识符
160
                "version": 1,
161
                "type": 5
162
              }
163
            ],
164
            "Privilege": 10,
165
            "PrepublishInfo": {
166
              "ReserveCount": 0,
167
              "DisplayTime": "",
168
              "Id": 0,
169
              "PublishTime": ""
170
            },
171
            "HQPkgPrice": 1,
172
            "OwnerCount": 93047,
173
            "Uploader": "",
174
            "Duration": 182,
175
            "SQFailProcess": 4,
176
            "TopID": 0,
177
            "A320Privilege": 10,
178
            "FileName": "ARI HICKS - Kiss Me, Kill Me", // 音乐文件名
179
            "ResFileSize": 38168107,
180
            "SQPrivilege": 10,
181
            "Price": 200,
182
            "recommend_type": 0,
183
            "Publish": 1
184
          },
185
          // 更多结果

可以看到，我们需要的 FileHash 为 0FD4158049ABCF692DA7E4D1C1AA963A。

第四步：下载音乐#

https://kugoumusicapi-docs.4everland.app/#/?id=获取音乐-url

重要
如果获取的是 VIP 歌曲，即未开通会员仅可试听的音乐，需要酷狗概念版VIP。参考 #第二步：领取VIP 。
强制获取需要概念版VIP的歌曲URL，将会提示 {"errcode":20028,"status":0,"error":"本次请求需要验证"}。

下载音乐需要用到 #第三步：搜索音乐的 FileHash 和音质（可选，不指定将获取最低音质）。

常用的部分音质 quality： 128：128kbps .mp3 格式，标准 320：320kbps .mp3 格式，高品 flac：.flac 格式，无损，无加密 high：.flac 格式，Hi-Res，无加密

注意：部分歌曲没有对应的高音质（如无 Hi-Res 的音乐依然请求 &quality=high），返回的音乐 URL 将为 128kbps 的 .mp3 音乐

1
# hash 为第三步获取的 FileHash。不必取消缓存。
2
# hash=0FD4158049ABCF692DA7E4D1C1AA963A，quality=high（Hi-Res）
3
https://kugou.cl.nz/song/url?hash=0FD4158049ABCF692DA7E4D1C1AA963A&quality=high

将会返回：

1
{
2
  "extName": "flac", // 音频文件的扩展名
3
  "classmap": {
4
    "attr0": 234881032
5
  },
6
  "status": 1,
7
  "volume": -8.4,
8
  "std_hash_time": 182778,
9
  "backupUrl": [
10
    "http://fs.youthandroid.kugou.com/202510181811/474420aee993e180059c8251e69abd37/v3/cd2cb994a5d61faba86f258731cecf5e/yp/full/ap3116_us1416117396_mi336d5ebc5436534e61d16e63ddfca327_pi411_mx0_quhigh_s3753791114.flac" // 最终音乐源文件
11
  ],
38 collapsed lines
12
  "url": [
13
    "http://fs.youthandroid2.kugou.com/202510181811/08d7aef6a8e7368c33746fe52d707702/v3/cd2cb994a5d61faba86f258731cecf5e/yp/full/ap3116_us1416117396_mi336d5ebc5436534e61d16e63ddfca327_pi411_mx0_quhigh_s3753791114.flac",
14
    "http://fs.youthandroid.kugou.com/202510181811/474420aee993e180059c8251e69abd37/v3/cd2cb994a5d61faba86f258731cecf5e/yp/full/ap3116_us1416117396_mi336d5ebc5436534e61d16e63ddfca327_pi411_mx0_quhigh_s3753791114.flac"
15
  ],
16
  "std_hash": "0FD4158049ABCF692DA7E4D1C1AA963A",
17
  "tracker_through": {
18
    "identity_block": 0,
19
    "cpy_grade": 5,
20
    "musicpack_advance": 1,
21
    "all_quality_free": 0,
22
    "cpy_level": 1
23
  },
24
  "trans_param": {
25
    "display_rate": 0,
26
    "display": 0,
27
    "ogg_128_hash": "A38E084A07325BCD0DD037F8145FA349",
28
    "qualitymap": {
29
      "attr0": 2134884468,
30
      "attr1": 136511488
31
    },
32
    "pay_block_tpl": 1,
33
    "union_cover": "http://imge.kugou.com/stdmusic/{size}/20221103/20221103054712785952.jpg",
34
    "language": "英语",
35
    "hash_multitrack": "8849F7DF7102CC5973C665C130EB2AED",
36
    "cpy_attr0": 58735744,
37
    "ipmap": {
38
      "attr0": 8606716928
39
    },
40
    "ogg_320_hash": "215E60CC931F0D02115735C082DCF590",
41
    "classmap": {
42
      "attr0": 234881032
43
    },
44
    "ogg_128_filesize": 2229498,
45
    "ogg_320_filesize": 8233880
46
  },
47
  "fileHead": 100,
48
  "auth_through": [],
49
  "timeLength": 182,
50
  "bitRate": 1671000, // 音频文件比特率
4 collapsed lines
51
  "priv_status": 1,
52
  "volume_peak": 0.1,
53
  "volume_gain": 0,
54
  "q": 0,
55
  "fileName": "002Y3LRz3yuT7N_000ifoEu1gY44L.flac", // 音乐文件名，出现这种需要以第三步中搜索的音乐中的 FileName 为准
56
  "fileSize": 38168107,
57
  "hash": "CD2CB994A5D61FABA86F258731CECF5E" // 此音频文件的哈希值
58
}

其中 backupUrl 中的

1
http://fs.youthandroid.kugou.com/202510181811/474420aee993e180059c8251e69abd37/v3/cd2cb994a5d61faba86f258731cecf5e/yp/full/ap3116_us1416117396_mi336d5ebc5436534e61d16e63ddfca327_pi411_mx0_quhigh_s3753791114.flac

即为我们需要的音频源文件。
下载到的音频文件不是我们想要的，可以在 #第三步：搜索音乐中找到 FileName，再与第四步中 extName 结合即可。
可以看到，下载下来的音频是有歌手名的源文件： kugou-music-example-details-2

两种VIP的不同点#

酷狗概念版中有2种不同的VIP等级之分。分别是概念版VIP和畅听VIP。

	下载VIP歌曲	播放 Hi-Res 音质音乐	可通过签到获得	每次最大下载数
概念版 VIP	✔	✔	❌	500
畅听 VIP	❌	❌	✔	-

kugou-music-lite-app-vippage