bilibili API 文档

当前提供 bilibili 视频解析、番剧、直播、字幕和元数据接口实现

认证

参数	类型	说明
`code`	string	必填，当前 2FA 验证码
`p`	integer	可选，视频分 P，默认 `1`
`bvid`	string	BV 号，如 `BV1ca4y1x7L9`
`relay`	boolean	视频解析可选，传入 `true` 时启用中转模式

旧版接口 /{BV}?p=1&code=123456 仍然兼容，无需更新浏览器扩展

基础模式下最高画质 720P / 1080P
中转模式下自动最高画质

视频解析

GET/api/v1/videos/{bvid}/play-url?p=1&code=123456

curl "https://bilibili.r18.zip/api/v1/videos/BV1ca4y1x7L9/play-url?p=1&code=123456"

{
  "ok": true,
  "status": "success",
  "data": {
    "bvid": "BV1ca4y1x7L9",
    "part": 1,
    "url": "https://upos-sz-mirror08c.bilivideo.com/...",
    "cached": false,
    "expires_in": 900
  }
}

更多接口

方法	路径	说明
`GET`	`/api/v1/videos/{bvid}/metadata?code={2fa}`	获取标题、UP 主、封面、字幕等元数据
`GET`	`/api/v1/bangumi/{season_id}/play-url?code={2fa}`	番剧 / 大会员专享内容解析
`GET`	`/api/v1/live/{room_id}/play-url?code={2fa}`	直播流地址解析
`GET`	`/api/v1/danmaku?bvid=...&p=1&code={2fa}`	获取弹幕信息

番剧 / 直播流需经过服务器中转，因此只能在私人房(好友房)使用

错误码

code	说明
`INVALID_BVID`	未提供有效 BV 号
`INVALID_SSID`	未提供有效 season ID
`INVALID_ROOMID`	未提供有效直播间 ID
`INVALID_CODE`	2FA 验证码缺失或错误
`CODE_LIMIT_REACHED`	验证码使用次数已达上限
`PARSING_ERROR`	后端服务解析异常