参数名	类型	必填	说明	示例
key	string	是	接口调用密钥
action	string	是	操作方法：play=解析播放地址 / detail=获取详情 / refresh_token=刷新TV凭据 / token_status=查看凭据状态	play
url	string	否	目标链接或ID（action=play/detail时必填），支持 ep号/ss整季/BV号/av号/b23.tv短链/完整网页链接	https://www.bilibili.com/bangumi/play/ep4697996
qn	string	否	画质代号（仅action=play），不传或传all返回所有可用画质，可选 16/32/64/80/112/120	all
format	string	否	返回格式（仅action=play），mp4=单文件整段（默认），dash=音视频分离多码率流	mp4
try_look	integer	否	未登录试看（仅action=play），1=开启，仅会员集有效	0
redirect	integer	否	302跳转开关（仅action=play），1=直接跳转到播放地址不返回JSON	0
page	integer	否	投稿视频分P序号（action=play/detail可用），默认1	1
cookie	string	否	自定义Web Cookie（SESSDATA等），用于解锁会员内容，仅本次请求生效不落盘	SESSDATA=xxx; bili_jct=xxx; DedeUserID=xxx
access_key	string	否	自定义TV端access_key（传access_token同义），优先于服务端配置，仅本次请求生效不落盘	94f4e8efb5ae1db6e911f536b0f74c91
refresh_token	string	否	自定义refresh_token，配合access_key使用；若触发轮换，新凭据通过响应token_rotated字段完整返还，旧token作废	21850bb4ade7377a0b78a718139f6b91

比莉Parser

接口说明

比莉Parser 提供 B 站影视、番剧及投稿视频的视频解析服务，支持通过 Play、详情查询、凭据刷新等操作获取播放地址与剧集信息。面向需要在移动端、TV 端或第三方播放器中调用 B 站内容的开发者，接口以 Query 鉴权方式接收请求，调用时需携带有效密钥。

调用地址

/api/parser/bili/index.php

请求方式

支持 GET 和 POST 两种请求方法。

鉴权说明

本接口为收费接口，调用时必须提供密钥。密钥通过 Query 参数传递，参数名为 key。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥
action	string	是	操作方法：`play` 解析播放地址 / `detail` 获取详情 / `refresh_token` 刷新TV凭据 / `token_status` 查看凭据状态
url	string	否	目标链接或ID（`action=play/detail` 时必填），支持 ep号、ss整季、BV号、av号、b23.tv短链、完整网页链接
qn	string	否	画质代号（仅 `action=play`），不传或传 `all` 返回所有可用画质，可选值 `16` / `32` / `64` / `80` / `112` / `120`
format	string	否	返回格式（仅 `action=play`），`mp4` 单文件整段（默认），`dash` 音视频分离多码率流
try_look	integer	否	未登录试看（仅 `action=play`），`1` 开启，仅会员集有效
redirect	integer	否	302跳转开关（仅 `action=play`），`1` 直接跳转到播放地址不返回JSON
page	integer	否	投稿视频分P序号（`action=play/detail` 可用），默认 `1`
cookie	string	否	自定义Web Cookie（SESSDATA等），用于解锁会员内容，仅本次请求生效不落盘
access_key	string	否	自定义TV端 access_key（传 access_token 同义），优先于服务端配置，仅本次请求生效不落盘
refresh_token	string	否	自定义 refresh_token，配合 access_key 使用；若触发轮换，新凭据通过响应 `token_rotated` 字段完整返还，旧 token 作废

参数取值说明

action 枚举值：play、detail、refresh_token、token_status
format 枚举值：mp4、dash
qn 常见代号与画质对应关系：16 流畅 360P、32 高清 480P、64 高清 720P、80 高清 1080P、112 高清 1080P+、120 超清 4K
page 从 1 开始计数，表示投稿视频的对应分P序号

成功响应示例

{
  "code": 200,
  "msg": "成功",
  "data": {
    "type": "pgc",
    "season_title": "昭阳公主",
    "ep_title": "1 檀郎变状元",
    "badge": "限免",
    "multi_quality": true,
    "channel": "tv",
    "format": "mp4",
    "quality": 64,
    "quality_name": "高清 720P",
    "qualities": [
      {
        "id": 112,
        "name": "高清 1080P+"
      },
      {
        "id": 80,
        "name": "高清 1080P"
      },
      {
        "id": 64,
        "name": "高清 720P"
      },
      {
        "id": 16,
        "name": "流畅 360P"
      }
    ],
    "url": "http://cn-sh-cc-01-15.bilivideo.com/upgcxcode/34/89/40131888934/40131888934-1-192.mp4?e=ig8euxZM2rNcNbRVhwdVhwdlhWdVhwdVhoNvNC8BqJIzNbfqXBvEuENvNC8aNEVEtEvE9IMvXBvE2ENvNCImNEVEIj0Y2J_aug859r1qXg8gNEVE5XREto8z5JZC2X2gkX5L5F1eTX1jkXlsTXHeux_f2o859IMvNC8xNbLEkF6MuwLStj8fqJ0EkX1ftx7Sqr_aio8_&ua=tvproj&deadline=1788849809&oi=3550604333&gen=playurlv3&og=ali&mid=384327705&uipk=5&trid=0000b927d28869d74001b76dcf042cbad28T&os=bcache&nbs=1&upsig=33e219edd413c820bb418a507c54d11b&uparams=e,ua,deadline,oi,gen,og,mid,uipk,trid,os,nbs&cdnid=9763&bvc=vod&nettype=0&bw=717050&lrs=0&qn_dyeid=&mobi_app=android&allo_id=&agrr=0&np=151355465&buvid=XY00DFB0E21789F0808B1C62151DC881B9774&build=0&dl=0&f=T_0_0&orderid=0,3",
    "backup_urls": [],
    "total_size": 0,
    "duration_ms": 0,
    "variants": [
      {
        "channel": "tv",
        "format": "mp4",
        "quality": 64,
        "quality_name": "高清 720P",
        "qualities": [
          {"id": 112, "name": "高清 1080P+"},
          {"id": 80, "name": "高清 1080P"},
          {"id": 64, "name": "高清 720P"},
          {"id": 16, "name": "流畅 360P"}
        ],
        "segments": [
          {
            "order": 1,
            "urls": ["http://cn-sh-cc-01-15.bilivideo.com/upgcxcode/34/89/40131888934/40131888934-1-192.mp4?e=ig8euxZM2rNcNbRVhwdVhwdlhWdVhwdVhoNvNC8BqJIzNbfqXBvEuENvNC8a

## 错误响应示例

```json
{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

业务错误码说明

errcode	含义
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用
11023	密钥已过期
11024	令牌分配积分不足

调用示例

终端 curl（bash）

curl -X POST "https://api.example.com/api/parser/bili/index.php?key=YOUR_KEY&action=play&url=https%3A%2F%2Fwww.bilibili.com%2Fbangumi%2Fplay%2Fep4697996&qn=all"

PHP

// PHP - Bili Parser
$url = 'https://api.example.com/api/parser/bili/index.php'
    . '?key=' . urlencode($apiKey)
    . '&action=play'
    . '&url=' . urlencode('https://www.bilibili.com/bangumi/play/ep4697996')
    . '&qn=all';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($response, true);
if ($data['code'] === 200) {
    echo $data['data']['url'];
}

注意事项

接口调用密钥 key 需妥善保存，不得嵌入前端页面、公开仓库或用户可见的代码中，避免被盗用导致额度损失。
本接口采用 Query 鉴权，key 以 URL 查询参数形式传递（如 ?key=xxx），请勿将密钥拼接在请求体或 Header 中。
返回的播放链接含签名参数，有效期有限，过期后需重新请求解析，直接复用旧链接可能导致播放失败。
action 参数仅支持 play、detail、refresh_token、token_status 四种取值，其余值将被拒绝。
qn 参数用于指定画质，有效值为 16、32、64、80、112、120 或 all；传入其他值可能返回默认画质或报错。
format 参数仅 action=play 时生效，mp4 返回单文件完整流（默认），dash 返回音视频分离的多码率分段流。
cookie 与 access_key 为本次请求临时使用，不会在服务端持久化存储，每次需主动传入。
access_key 与 refresh_token 配合使用时，若触发凭据轮换，响应中 token_rotated 字段将返回最新凭据，旧凭据立即作废。
请求 b23.tv 短链时，服务端会自动重定向解析，建议客户端允许 3xx 跳转或等待最终响应。
接口频率限制约为每分钟 120 次，超限将返回错误，请在高并发场景下做好限流与重试策略。
建议全站启用 HTTPS 传输，防止密钥及解析结果在链路中被拦截。
部分番剧或影视内容受 B 站区域版权限制，非会员内容需传入有效 cookie（含 SESSDATA）方可解锁，否则返回结果可能为空或仅含试看片段。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

比莉Parser

接口信息

请求参数

返回示例

详细文档

比莉Parser

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

whois查询