媒体下载与代理规则
下载时携带 Bilibili Referer、浏览器 User-Agent 并透传 Range。签名流过期后需要重新解析原始页面。
建议的后端请求头
User-Agent: Mozilla/5.0
Referer: https://www.bilibili.com/
Range: bytes=0-EasyDown REST API 平台指南
Bilibili / B站视频下载 API
多种 Bilibili URL 会被统一为一个选定视频项目，REST 响应保留可用视频、独立音频、缩略图、时长和画质数据。
使用 EasyDown Bilibili / B站视频下载 API 解析公开 BV、av、短链、列表、番剧及受支持的播放链接。
B站视频解析 API · Bilibili 下载接口
生产环境 REST Endpoint
POST https://api.easydown.org/api/v1/parse支持的公开 URL 格式
bilibili.com/video/BV...bilibili.com/video/av...b23.tv/{code}bilibili.com/bangumi/play/ep...真实请求示例
https://www.bilibili.com/video/BV1sW4y197cE/
curl -X POST https://api.easydown.org/api/v1/parse \
-H "Authorization: Bearer ed_live_xxx" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.bilibili.com/video/BV1sW4y197cE/"}'平台专属响应示例
统一响应外层保持稳定；具体平台决定哪些媒体数组和属性会被填充。
媒体返回行为
部分画质使用 DASH，视频与音频分别位于 videos[] 和 audios[]。选择两条流下载后，可在兼容时使用 FFmpeg 无重编码合并。
{
"status": 200,
"data": {
"platform": "bilibili",
"title": "Example bilibili public post",
"thumbnail": "https://cdn.example.com/thumbnail.jpg",
"duration": 24,
"images": [],
"videos": [
{
"url": "https://cdn.example.com/video.mp4",
"quality": "1080p video-only",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": false,
"source": "direct"
}
],
"audios": [
{
"url": "https://cdn.example.com/audio.m4a",
"quality": "128kbps",
"mimeType": "audio/mp4"
}
]
},
"msg": "success"
}不支持或不可用的内容
不支持主页、收藏夹、稍后再看、没有单视频 ID 的列表、付费内容、DRM 媒体和地区受限作品。
只处理你有权使用的公开媒体。EasyDown 不绕过隐私设置、DRM、已删除内容或平台访问限制。
平台专属排错
向用户交付前合并选定的 DASH 视频与音频流。
请求签名流时始终携带 Bilibili Referer。
流返回 403 或签名过期时重新解析。
REST 集成流程
- 1
创建私有 API Token，并在权限中允许该平台。
- 2
把一个完整的公开作品 URL POST 到统一 Endpoint。
- 3
从 images、videos、audios 中选择所需媒体并通过后端代理。
下载 API 常见问题
Bilibili / B站 下载 API 支持哪些 URL？
支持的公开单条作品格式包括 bilibili.com/video/BV..., bilibili.com/video/av..., b23.tv/{code}, bilibili.com/bangumi/play/ep...。不支持主页、收藏夹、稍后再看、没有单视频 ID 的列表、付费内容、DRM 媒体和地区受限作品。
Bilibili / B站 下载 API 会返回哪些媒体？
部分画质使用 DASH，视频与音频分别位于 videos[] 和 audios[]。选择两条流下载后，可在兼容时使用 FFmpeg 无重编码合并。
应用应该如何下载返回的 Bilibili / B站 媒体 URL？
下载时携带 Bilibili Referer、浏览器 User-Agent 并透传 Range。签名流过期后需要重新解析原始页面。
Bilibili / B站 API 成功请求如何扣费？
成功返回至少一条图片、视频或音频 URL 时扣 1 credit；失败、不支持、鉴权错误和空媒体结果不扣 credits。