Bilibili 下载器

快速开始

通过视频链接下载视频：

pip install bilibili-api-python
python -c "
from bilibili_api import video, sync
v = video.Video(bvid='BV1xx411c7m2')
sync(v.download(output='./video.mp4'))
"

下载选项

视频画质

• 使用 qn 参数指定画质（127=8K，126=杜比，125=1080P+ 等）
• 默认选择可用的最佳画质

音频下载

• 下载原始音轨：v.download_audio(output='./audio.mp3')
• 支持多种音频格式

字幕

• 获取可用字幕列表：v.get_subtitle()
• 下载字幕文件：sync(v.download_subtitle(output='./'))

封面与缩略图

• 获取封面图片链接：v.get_cover()
• 下载封面图片：sync(v.download_cover(output='./cover.jpg'))

常用操作

下载单个视频

from bilibili_api import video, sync
v = video.Video(bvid='BV1xx411c7m2')
sync(v.download(output='./video.mp4'))

指定画质下载

from bilibili_api import video, sync
v = video.Video(bvid='BV1xx411c7m2')
info = v.get_download_url(qn=127)  # 8K 画质

下载整个播放列表

from bilibili_api import video, sync
from bilibili_api import playlist

pl = playlist.Playlist(playlist_id='123456')
for v in sync(pl.get_videos()):
    sync(v.download(output=f'./playlist/{v["title"]}.mp4'))

仅下载音频

from bilibili_api import video, sync
v = video.Video(bvid='BV1xx411c7m2')
sync(v.download_audio(output='./audio.mp3'))

认证机制

对于需要会员权限的内容，请使用浏览器 Cookie：

1. 在浏览器中登录 Bilibili 账号
2. 导出 SESSDATA Cookie 的值
3. 设置环境变量：export BILIBILI_SESSDATA='your_cookie_value'

依赖要求

• bilibili-api-python：pip install bilibili-api-python
• ffmpeg：用于视频/音频处理
• Python 3.8+

资源

scripts/

用于常见下载操作的实用脚本。

references/

• bilibili-api 仓库中的 API 文档
• 画质码参考（qn 值）
• Cookie 配置指南

assets/

下载模板和配置示例。