BAC Document

音频流URL

音质qn参数定义

音质qn参数：

代码含义
0流畅 128K
1标准 192K
2高品质 320K
3无损 FLAC （大会员）

获取音频流URL(web端)

https://www.bilibili.com/audio/music-service-c/web/url

请求方式：GET

注：web端无法播放完整付费歌曲，付费歌曲为30s试听片段

本接口仅能获取192K音质的音频

url参数：

参数名类型内容必要性备注
sidnum音频auid必要
qualitynum2不必要
privilegenum2不必要

json回复：

根对象：

字段类型内容备注
codenum返回值0: 成功
4511006: 已跳过无法播放的歌曲
7201006：未找到或已下架
72000000：请求错误
messagestr返回值字符串形式的 code
msgstr返回信息成功为 success
dataobj数据本体

data对象：

字段类型内容备注
sidnum音频auid
typenum音质标识-1：试听片段（192K）
1：192K
infostr空
timeoutnum有效时长单位为秒
一般为3h
sizenum文件大小单位为字节
当type为-1时size为0
cdnsarray音频流url
qualitiesnull
titlestr空
coverstr空

data对象的cdns数组：

项类型内容备注
0str音频流url
1str备用音频流url可能不存在

示例：

curl -G 'https://www.bilibili.com/audio/music-service-c/web/url' \
--data-urlencode 'sid=777180'
查看响应示例：
{
  "code": 0,
  "data": {
    "sid": 777180,
    "title": "",
    "cover": "",
    "type": 1,
    "info": "",
    "timeout": 10800,
    "size": 5579903,
    "cdns": [
      "https://upos-sz-mirrorcos.bilivideo.com/ugaxcode/m190314ws1dikiap1oivtapctuj1agjc-192k.m4a?e=ig8euxZM2rNcNbdlhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1725013547&gen=playurlv2&os=cosbv&oi=1746706124&trid=493923009cef4225ab8e1b9bda42c635B&mid=0&platform=pc&og=cos&upsig=043779511e2770cf6c3da04ed8a89f25&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,mid,platform,og&bvc=vod&nettype=0&orderid=0,1&logo=00000000"
    ],
    "qualities": null
  },
  "message": "0",
  "msg": "success"
}

获取音频流URL（可获取付费音频）

https://api.bilibili.com/audio/music-service-c/url

请求方式：GET

认证方式：APP或Cookie（SESSDATA）

注：付费音乐需要有带大会员或音乐包的账号登录（Cookie或APP），否则为试听片段

无损音质需要登录的用户为会员

url参数：

参数名类型内容必要性备注
access_keystrAPP登录TokenAPP方式必要
songidnum音频auid必要
qualitynum音质代码必要详情见上表
privilegenum必须为2必要
midnum当前用户mid必要可为任意值
platformstr平台标识必要可为任意值

json回复：

根对象：

字段类型内容备注
codenum返回值0:成功
7201006：未找到或已下架
72000000：请求错误
msgstr错误信息默认为success
dataobj数据本体

data对象：

字段类型内容备注
sidnum音频auid
typenum音质标识-1：试听片段（192K）
0：128K
1：192K
2：320K
3：FLAC
infostr空作用尚不明确
timeoutnum有效时长单位为秒
一般为3h
sizenum文件大小单位为字节
当type为-1时size为0
cdnsarray音频流url
qualitiesarray音质列表
titlestr音频标题
coverstr音频封面url

data对象的cdns数组：

项类型内容备注
0str音频流url
1str备用音频流url

data对象的qualities数组：

项类型内容备注
0obj音质1音质由高向低顺序
nobj音质（n+1）

qualities数组中的对象：

字段类型内容备注
typenum音质代码详情见上表
descstr音质名称
sizenum该音质的文件大小单位为字节
bpsstr比特率标签
tagstr音质标签
requirenum是否需要会员权限0：不需要
1：需要
requiredescstr会员权限标签

示例：

获取音频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[n] 作为 URL 进行 GET 操作

需要验证请求头 User-Agent 不为空且不含敏感字串, 且 Referer 必须在 .bilibili.com 下

示例:

使用 cURL + FFPlay 直接从音频流播放

curl -G "https://upos-sz-mirrorcos.bilivideo.com/ugaxcode/7bf6a3a3e94421ccc653f005457b1e8c-192k.m4a?e=ig8euxZM2rNcNbdlhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1725013121&gen=playurlv2&os=cosbv&oi=1823807031&trid=1a4703f1e7344bb891691c5857e8cfb9B&mid=0&platform=pc&og=cos&upsig=e3a9fba59b46ab2720c8b1807844e9f3&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,mid,platform,og&bvc=vod&nettype=0&orderid=0,1&logo=00000000" \
--referer 'https://www.bilibili.com/' -A 'Mozilla/5.0' \
--output - | ffplay -