mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2024-12-27 13:00:29 +08:00
10 KiB
10 KiB
音频流URL
音质qn参数定义
音质qn参数：
| 代码 | 含义 |
|---|---|
| 0 | 流畅 128K |
| 1 | 标准 192K |
| 2 | 高品质 320K |
| 3 | 无损 FLAC （大会员） |
获取音频流URL(web端)
请求方式：GET
注：web端无法播放完整付费歌曲，付费歌曲为30s试听片段
本接口仅能获取192K音质的音频
url参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| sid | num | 音频auid | 必要 |
json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 7201006：未找到或已下架 72000000：请求错误 |
| msg | str | 错误信息 | 默认为success |
| data | obj | 数据本体 |
data对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| sid | num | 音频auid | |
| type | num | 音质标识 | -1：试听片段（192K） 1：192K |
| info | str | 空 | 作用尚不明确 |
| timeout | num | 有效时长 | 单位为秒 一般为3h |
| size | num | 文件大小 | 单位为字节 当 type为-1时size为0 |
| cdns | array | 音频流url | |
| qualities | null | - | |
| title | null | - | |
| cover | null | - |
data对象的cdns数组：
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | str | 音频流url | |
| 1 | str | 备用音频流url |
示例：
curl -G 'https://www.bilibili.com/audio/music-service-c/web/url' \
--data-urlencode 'sid=sid=15664'
查看响应示例：
{
"code": 0,
"msg": "success",
"data": {
"sid": 15664,
"type": 1,
"info": "",
"timeout": 10800,
"size": 4853263,
"cdns": [
"https://upos-sz-mirrorkodo.bilivideo.com/ugaxcode/7bf6a3a3e94421ccc653f005457b1e8c-192k.m4a?deadline=1595331310&gen=uga&os=kodobv&uparams=deadline,gen,os&upsig=0ecd3c7a8d9539f260239d8fa4c093db",
"https://upos-sz-mirrorks3.bilivideo.com/ugaxcode/7bf6a3a3e94421ccc653f005457b1e8c-192k.m4a?deadline=1595331310&gen=uga&os=ks3bv&uparams=deadline,gen,os&upsig=f3fe53aff56655b1b7264ae4ab65872e"
],
"qualities": null,
"title": null,
"cover": null
}
}
获取音频流URL（可获取付费音频）
请求方式：GET
认证方式：APP或Cookie（SESSDATA）
注：付费音乐需要有带大会员或音乐包的账号登录（Cookie或APP），否则为试听片段
无损音质需要登录的用户为会员
url参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP登录Token | APP方式必要 | |
| songid | num | 音频auid | 必要 | |
| quality | num | 音质代码 | 必要 | 详情见上表 |
| privilege | num | 必须为2 |
必要 | |
| mid | num | 当前用户mid | 必要 | 可为任意值 |
| platform | str | 平台标识 | 必要 | 可为任意值 |
json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 7201006：未找到或已下架 72000000：请求错误 |
| msg | str | 错误信息 | 默认为success |
| data | obj | 数据本体 |
data对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| sid | num | 音频auid | |
| type | num | 音质标识 | -1：试听片段（192K） 0：128K 1：192K 2：320K 3：FLAC |
| info | str | 空 | 作用尚不明确 |
| timeout | num | 有效时长 | 单位为秒 一般为3h |
| size | num | 文件大小 | 单位为字节 当 type为-1时size为0 |
| cdns | array | 音频流url | |
| qualities | array | 音质列表 | |
| title | str | 音频标题 | |
| cover | str | 音频封面url |
data对象的cdns数组：
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | str | 音频流url | |
| 1 | str | 备用音频流url |
data对象的qualities数组：
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 音质1 | 音质由高向低顺序 |
| n | obj | 音质（n+1） |
qualities数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| type | num | 音质代码 | 详情见上表 |
| desc | str | 音质名称 | |
| size | num | 该音质的文件大小 | 单位为字节 |
| bps | str | 比特率标签 | |
| tag | str | 音质标签 | |
| require | num | 是否需要会员权限 | 0：不需要 1：需要 |
| requiredesc | str | 会员权限标签 |
示例：
获取音频au682118的音频流url，音质为3（无损）
Cookie方式：
curl -G 'https://api.bilibili.com/audio/music-service-c/url
--data-urlencode 'songid=682118' \
--data-urlencode 'quality=3' \
--data-urlencode 'privilege=2' \
--data-urlencode 'platform=android' \
--data-urlencode 'mid=293793435' \
-b 'SESSDATA=xxx'
APP方式：
curl -G 'https://api.bilibili.com/audio/music-service-c/url
--data-urlencode 'access_key=xxx' \
--data-urlencode 'songid=682118' \
--data-urlencode 'quality=3' \
--data-urlencode 'privilege=2' \
--data-urlencode 'platform=android' \
--data-urlencode 'mid=293793435'
查看响应示例：
{
"code": 0,
"msg": "success",
"data": {
"sid": 682118,
"type": 3,
"info": "",
"timeout": 10800,
"size": 34456494,
"cdns": [
"https://upos-sz-mirrorkodo.bilivideo.com/ugaxcode/m190102ws2pzf6jitbem841vq2x0du5x-flac.flac?deadline=1595332269&gen=uga&os=kodobv&uparams=deadline,gen,os&upsig=ac2284d97a61ef8758681eccf621c56d",
"https://upos-sz-mirrorks3.bilivideo.com/ugaxcode/m190102ws2pzf6jitbem841vq2x0du5x-flac.flac?deadline=1595332269&gen=uga&os=ks3bv&uparams=deadline,gen,os&upsig=3ac7d94dda5664f6f95dbfffeb289744"
],
"qualities": [
{
"type": 3,
"desc": "无损音质",
"size": 34456494,
"bps": "",
"tag": "SQ",
"require": 1,
"requiredesc": "付费享受"
},
{
"type": 2,
"desc": "高品质",
"size": 10788682,
"bps": "320kbit/s",
"tag": "HQ",
"require": 0,
"requiredesc": ""
},
{
"type": 1,
"desc": "标准",
"size": 6491973,
"bps": "192kbit/s",
"tag": "",
"require": 0,
"requiredesc": ""
},
{
"type": 0,
"desc": "流畅",
"size": 4343667,
"bps": "128kbit/s",
"tag": "",
"require": 0,
"requiredesc": ""
}
],
"title": "aLIEz",
"cover": "http://i0.hdslb.com/bfs/music/61d3f8cfdce14d2d1b006af59559c9bd22a2d21b.jpg"
}
}
音频流的获取
将data.cdns.[0]或data.cdns.[1]中的内容作为url进行GET操作
需要验证请求user-agent 不为空
user-agent错误并且referer不在*.bilibili.com域名下的情况下会导致403 Forbidden，故无法获取
以上述音频url为例：
wget 'https://upos-sz-mirrorkodo.bilivideo.com/ugaxcode/m190102ws2pzf6jitbem841vq2x0du5x-flac.flac?deadline=1595332269&gen=uga&os=kodobv&uparams=deadline,gen,os&upsig=ac2284d97a61ef8758681eccf621c56d' \
-O 'Download_music.flac'
响应正文将返回一个flac文件