接口简介:
获取B站指定房间直播播放地址。
请求地址:
https://cn.apihz.cn/api/fun/bilizb.php
请求方式:
POST或GET。
请求参数:
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID,例:id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2】
【房间号】【room】【是】【真实房间号或短号,例:room=100】
返回参数:
【名称】【参数】【说明】
【状态码】【code】【200成功,400错误。】
【信息提示】【msg】【信息提示。】
【获取通道】【td】【平台获取通道。】
【真实房间号】【room_id】【真实房间号。】
【短位房间号】【short_id】【短位房间号。】
【主播ID】【uid】【主播ID。】
【直播状态】【live_status】【1=正在直播,0=未开播,2=轮播。】
【直播开始时间戳】【live_time】【直播开始时间戳。】
【是否隐藏】【is_hidden】【直播间是否被隐藏。】
【是否锁定】【is_locked】【直播间是否被锁定。】
【格式化开播时间】【live_time_readable】【格式化开播时间。】
【清晰度描述数据集】【quality_descriptions】【清晰度描述数据集。】
【播放信息数据集】【play】【播放信息数据集。】
【流媒体协议】【play.protocol】【 http_stream: FLV流,延迟低。http_hls: HLS流,兼容性好。】
【封装格式】【play.format】【封装格式。】
【视频编码】【play.codec】【avc: H.264编码,兼容性好。hevc: H.265编码,压缩率高。】
【清晰度ID】【play.quality_id】【清晰度ID。】
【清晰度描述】【play.quality_desc】【清晰度描述。】
【基础URL路径】【play.base_url】【基础URL路径。】
【播放地址数据集】【play.urls】【播放地址数据集。】
【序号】【play.urls.order】【1为主节点,2为备用节点。】
【CDN主机】【play.urls.host】【内容分发网络的服务器域名。】
【播放地址】【play.urls.url】【完整播放地址。】
GET请求示例:
https://cn.apihz.cn/api/fun/bilizb.php?id=88888888&key=88888888&room=100
注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。
POST请求示例:
请根据开发语言自行POST。
返回数据示例:
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:{"code":400,"msg":"房间不存在"}
示例:
{
"td": 1,
"room_id": 3742025,
"short_id": 439,
"uid": 93841264,
"live_status": 1,
"live_time": 1774414751,
"is_hidden": false,
"is_locked": false,
"live_time_readable": "2026-03-25 12:59:11",
"quality_descriptions": {
"30000": "杜比",
"20000": "4K",
"15000": "2K",
"10000": "原画",
"400": "蓝光",
"250": "超清",
"150": "高清",
"80": "流畅"
},
"play": [
{
"protocol": "http_stream",
"format": "flv",
"codec": "avc",
"quality_id": 250,
"quality_desc": "超清",
"base_url": "/live-bvc/961787/live_93841264_4272534_2500.flv?",
"urls": [
{
"order": 1,
"host": "https://ec-jssz-ct-01-10.bilivideo.com",
"url": "https://ec-jssz-ct-01-10.bilivideo.com/live-bvc/961787/live_93841264_4272534_2500.flv??expires=1774430510&pt=html5&deadline=1774430510&len=0&oi=2050184017&platform=html5&qn=250&trid=10002cf06bd1f0c342ee0271cda64e69c39b&uipk=100&uipv=100&nbs=1&bmt=2&uparams=cdn,deadline,len,oi,platform,qn,trid,uipk,uipv,nbs,bmt&cdn=cn-gotcha01&upsig=923e1b8c19de041580f992f4ea127754&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&sid=ec-jssz-ct-01-10&chash=1&sg=cs&trace=29&isp=ct&rg=East&pv=Shanghai&suffix=2500&pp=srt&strategy_id=25&strategy_type=0&info_source=cache&p2p_type=-1&origin_bitrate=2055&source=puv3_onetier&score=1&codec=0&strategy_ids=25,122&media_type=0&long_ab_flag_value=test&strategy_version=latest&long_ab_id=45&ld=jchz&sk=187146f299f4c99cfc0e59e94d9504f9&expected_qn=250&long_ab_flag=live_default_longitudinal&deploy_env=prod&sl=2&strategy_types=0,1&hdr_type=0&hot_cdn=57353&vd=dec&zoneid_l=151355393&sid_l=stream_name_cold&src=puv3&order=1"
},
{
"order": 2,
"host": "https://ec-jssz-ct-01-10.bilivideo.com",
"url": "https://ec-jssz-ct-01-10.bilivideo.com/live-bvc/961787/live_93841264_4272534_2500.flv??expires=1774430510&pt=html5&deadline=1774430510&len=0&oi=2050184017&platform=html5&qn=250&trid=10002cf06bd1f0c342ee0271cda64e69c39b&uipk=100&uipv=100&nbs=1&bmt=2&uparams=cdn,deadline,len,oi,platform,qn,trid,uipk,uipv,nbs,bmt&cdn=cn-gotcha01&upsig=923e1b8c19de041580f992f4ea127754&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&sid=ec-jssz-ct-01-10&chash=1&sg=cs&trace=29&isp=ct&rg=East&pv=Shanghai&suffix=2500&pp=srt&strategy_id=25&strategy_type=0&info_source=cache&p2p_type=-1&origin_bitrate=2055&source=puv3_onetier&score=1&codec=0&strategy_ids=25,122&media_type=0&long_ab_flag_value=test&strategy_version=latest&long_ab_id=45&ld=jchz&sk=187146f299f4c99cfc0e59e94d9504f9&expected_qn=250&long_ab_flag=live_default_longitudinal&deploy_env=prod&sl=2&strategy_types=0,1&hdr_type=0&hot_cdn=57353&vd=dec&zoneid_l=151355393&sid_l=stream_name_cold&src=puv3&order=2"
}
]
},
{
"protocol": "http_stream",
"format": "flv",
"codec": "hevc",
"quality_id": 250,
"quality_desc": "超清",
"base_url": "/live-bvc/497072/live_93841264_4272534_minihevc.flv?",
"urls": [
{
"order": 1,
"host": "https://d1--cn-gotcha07.bilivideo.com",
"url": "https://d1--cn-gotcha07.bilivideo.com/live-bvc/497072/live_93841264_4272534_minihevc.flv??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10002cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha07&sign=567dcc04c774a29cafc279370c47a811&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&trace=20&isp=ct&rg=East&pv=Shanghai&strategy_type=0&strategy_types=0,1&strategy_id=25&origin_bitrate=1451&expected_qn=250&deploy_env=prod&sl=2&pp=srt&strategy_ids=25,122&score=54&info_source=cache&source=puv3_onetier&ld=jchz&codec=1&long_ab_flag=live_default_longitudinal&media_type=0&hot_cdn=57353&sk=7b9ca197a822eebb7933bf2a49b49d0f35ad7f43194d91190f30a6d34e2cb7db&long_ab_flag_value=test&hdr_type=0&suffix=minihevc&long_ab_id=45&p2p_type=-1&strategy_version=latest&vd=bc&src=puv3&order=1"
},
{
"order": 2,
"host": "https://d1--cn-gotcha07b.bilivideo.com",
"url": "https://d1--cn-gotcha07b.bilivideo.com/live-bvc/497072/live_93841264_4272534_minihevc.flv??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10002cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha07&sign=567dcc04c774a29cafc279370c47a811&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&trace=20&isp=ct&rg=East&pv=Shanghai&strategy_type=0&strategy_types=0,1&strategy_id=25&origin_bitrate=1451&expected_qn=250&deploy_env=prod&sl=2&pp=srt&strategy_ids=25,122&score=54&info_source=cache&source=puv3_onetier&ld=jchz&codec=1&long_ab_flag=live_default_longitudinal&media_type=0&hot_cdn=57353&sk=7b9ca197a822eebb7933bf2a49b49d0f35ad7f43194d91190f30a6d34e2cb7db&long_ab_flag_value=test&hdr_type=0&suffix=minihevc&long_ab_id=45&p2p_type=-1&strategy_version=latest&vd=bc&src=puv3&order=2"
}
]
},
{
"protocol": "http_hls",
"format": "ts",
"codec": "avc",
"quality_id": 250,
"quality_desc": "超清",
"base_url": "/live-bvc/569086/live_93841264_4272534_2500.m3u8?",
"urls": [
{
"order": 1,
"host": "https://d1--cn-gotcha104.bilivideo.com",
"url": "https://d1--cn-gotcha104.bilivideo.com/live-bvc/569086/live_93841264_4272534_2500.m3u8??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10032cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha104&sign=dcc4427d2921db757c4e3cb499dad8fe&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&trace=20&isp=ct&rg=East&pv=Shanghai&hot_cdn=57353&strategy_id=25&strategy_type=0&p2p_type=-1&score=1&sk=187146f299f4c99cfc0e59e94d9504f9&pp=srt&long_ab_flag_value=test&long_ab_flag=live_default_longitudinal&sl=2&deploy_env=prod&strategy_types=0,1&expected_qn=250&strategy_version=latest&info_source=cache&ld=jchz&long_ab_id=45&hdr_type=0&media_type=0&codec=0&source=puv3_onetier&origin_bitrate=2055&strategy_ids=25,122&suffix=2500&vd=bc&src=puv3&order=1"
},
{
"order": 2,
"host": "https://d1--cn-gotcha104b.bilivideo.com",
"url": "https://d1--cn-gotcha104b.bilivideo.com/live-bvc/569086/live_93841264_4272534_2500.m3u8??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10032cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha104&sign=dcc4427d2921db757c4e3cb499dad8fe&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&trace=20&isp=ct&rg=East&pv=Shanghai&hot_cdn=57353&strategy_id=25&strategy_type=0&p2p_type=-1&score=1&sk=187146f299f4c99cfc0e59e94d9504f9&pp=srt&long_ab_flag_value=test&long_ab_flag=live_default_longitudinal&sl=2&deploy_env=prod&strategy_types=0,1&expected_qn=250&strategy_version=latest&info_source=cache&ld=jchz&long_ab_id=45&hdr_type=0&media_type=0&codec=0&source=puv3_onetier&origin_bitrate=2055&strategy_ids=25,122&suffix=2500&vd=bc&src=puv3&order=2"
}
]
},
{
"protocol": "http_hls",
"format": "ts",
"codec": "hevc",
"quality_id": 250,
"quality_desc": "超清",
"base_url": "/live-bvc/407273/live_93841264_4272534_minihevc.m3u8?",
"urls": [
{
"order": 1,
"host": "https://d1--cn-gotcha104.bilivideo.com",
"url": "https://d1--cn-gotcha104.bilivideo.com/live-bvc/407273/live_93841264_4272534_minihevc.m3u8??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10032cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha104&sign=c89130e811b39f55d872b9aec0213204&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&trace=20&isp=ct&rg=East&pv=Shanghai&expected_qn=250&strategy_types=0,1&source=puv3_onetier&p2p_type=-1&ld=jchz&media_type=0&sk=7b9ca197a822eebb7933bf2a49b49d0f35ad7f43194d91190f30a6d34e2cb7db&strategy_version=latest&hot_cdn=57353&suffix=minihevc&sl=2&pp=srt&hdr_type=0&strategy_type=0&long_ab_flag=live_default_longitudinal&info_source=cache&strategy_id=25&long_ab_flag_value=test&long_ab_id=45&score=54&deploy_env=prod&strategy_ids=25,122&origin_bitrate=1451&codec=1&vd=bc&src=puv3&order=1"
},
{
"order": 2,
"host": "https://d1--cn-gotcha104b.bilivideo.com",
"url": "https://d1--cn-gotcha104b.bilivideo.com/live-bvc/407273/live_93841264_4272534_minihevc.m3u8??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10032cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha104&sign=c89130e811b39f55d872b9aec0213204&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&trace=20&isp=ct&rg=East&pv=Shanghai&expected_qn=250&strategy_types=0,1&source=puv3_onetier&p2p_type=-1&ld=jchz&media_type=0&sk=7b9ca197a822eebb7933bf2a49b49d0f35ad7f43194d91190f30a6d34e2cb7db&strategy_version=latest&hot_cdn=57353&suffix=minihevc&sl=2&pp=srt&hdr_type=0&strategy_type=0&long_ab_flag=live_default_longitudinal&info_source=cache&strategy_id=25&long_ab_flag_value=test&long_ab_id=45&score=54&deploy_env=prod&strategy_ids=25,122&origin_bitrate=1451&codec=1&vd=bc&src=puv3&order=2"
}
]
},
{
"protocol": "http_hls",
"format": "fmp4",
"codec": "avc",
"quality_id": 250,
"quality_desc": "超清",
"base_url": "/live-bvc/782823/live_93841264_4272534_2500/index.m3u8?",
"urls": [
{
"order": 1,
"host": "https://d1--cn-gotcha204.bilivideo.com",
"url": "https://d1--cn-gotcha204.bilivideo.com/live-bvc/782823/live_93841264_4272534_2500/index.m3u8??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10072cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha204&sign=6315e1265271471c6bf030e7af52da2c&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&bvchls=1&trace=20&isp=ct&rg=East&pv=Shanghai&sk=71044d8bf8030bcec38e8861f65cd51f&suffix=2500&hdr_type=0&deploy_env=prod&hot_cdn=57353&strategy_ids=25,122&codec=0&flvsk=187146f299f4c99cfc0e59e94d9504f9&long_ab_id=45&info_source=cache&p2p_type=-1&ld=jchz&origin_bitrate=2055&score=1&sl=2&long_ab_flag=live_default_longitudinal&expected_qn=250&long_ab_flag_value=test&source=puv3_onetier&strategy_types=0,1&strategy_id=25&strategy_type=0&strategy_version=latest&media_type=0&pp=srt&vd=bc&src=puv3&order=1"
},
{
"order": 2,
"host": "https://d1--cn-gotcha204b.bilivideo.com",
"url": "https://d1--cn-gotcha204b.bilivideo.com/live-bvc/782823/live_93841264_4272534_2500/index.m3u8??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10072cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha204&sign=6315e1265271471c6bf030e7af52da2c&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&bvchls=1&trace=20&isp=ct&rg=East&pv=Shanghai&sk=71044d8bf8030bcec38e8861f65cd51f&suffix=2500&hdr_type=0&deploy_env=prod&hot_cdn=57353&strategy_ids=25,122&codec=0&flvsk=187146f299f4c99cfc0e59e94d9504f9&long_ab_id=45&info_source=cache&p2p_type=-1&ld=jchz&origin_bitrate=2055&score=1&sl=2&long_ab_flag=live_default_longitudinal&expected_qn=250&long_ab_flag_value=test&source=puv3_onetier&strategy_types=0,1&strategy_id=25&strategy_type=0&strategy_version=latest&media_type=0&pp=srt&vd=bc&src=puv3&order=2"
}
]
},
{
"protocol": "http_hls",
"format": "fmp4",
"codec": "hevc",
"quality_id": 250,
"quality_desc": "超清",
"base_url": "/live-bvc/797068/live_93841264_4272534_minihevc/index.m3u8?",
"urls": [
{
"order": 1,
"host": "https://d1--cn-gotcha204.bilivideo.com",
"url": "https://d1--cn-gotcha204.bilivideo.com/live-bvc/797068/live_93841264_4272534_minihevc/index.m3u8??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10072cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha204&sign=5e7ca9da51d8c27c5e872632b2d44c67&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&bvchls=1&trace=20&isp=ct&rg=East&pv=Shanghai&deploy_env=prod&expected_qn=250&strategy_version=latest&strategy_ids=25,122&ld=jchz&p2p_type=-1&codec=1&hdr_type=0&info_source=cache&strategy_id=25&long_ab_flag=live_default_longitudinal&sl=2&pp=srt&score=54&origin_bitrate=1451&sk=11e6e03140d4fe707653c968459991d3585e5b45a8cf294402cc16df098d292a&suffix=minihevc&media_type=0&source=puv3_onetier&long_ab_id=45&strategy_types=0,1&flvsk=7b9ca197a822eebb7933bf2a49b49d0f35ad7f43194d91190f30a6d34e2cb7db&strategy_type=0&hot_cdn=57353&long_ab_flag_value=test&vd=bc&src=puv3&order=1"
},
{
"order": 2,
"host": "https://d1--cn-gotcha204b.bilivideo.com",
"url": "https://d1--cn-gotcha204b.bilivideo.com/live-bvc/797068/live_93841264_4272534_minihevc/index.m3u8??expires=1774430510&len=0&oi=2050184017&pt=html5&qn=250&trid=10072cf06bd1f0c342ee0271cda64e69c39b&bmt=2&sigparams=cdn,expires,len,oi,pt,qn,trid,bmt&cdn=cn-gotcha204&sign=5e7ca9da51d8c27c5e872632b2d44c67&site=e74891cb388a3c1daed63834f93dbb6d&free_type=0&mid=0&sche=ban&bvchls=1&trace=20&isp=ct&rg=East&pv=Shanghai&deploy_env=prod&expected_qn=250&strategy_version=latest&strategy_ids=25,122&ld=jchz&p2p_type=-1&codec=1&hdr_type=0&info_source=cache&strategy_id=25&long_ab_flag=live_default_longitudinal&sl=2&pp=srt&score=54&origin_bitrate=1451&sk=11e6e03140d4fe707653c968459991d3585e5b45a8cf294402cc16df098d292a&suffix=minihevc&media_type=0&source=puv3_onetier&long_ab_id=45&strategy_types=0,1&flvsk=7b9ca197a822eebb7933bf2a49b49d0f35ad7f43194d91190f30a6d34e2cb7db&strategy_type=0&hot_cdn=57353&long_ab_flag_value=test&vd=bc&src=puv3&order=2"
}
]
}
]
}
参考资料(版权):
https://www.apihz.cn/api/funbilizb.html