接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 房间号 | room | 是 | 真实房间号或短号，例：room=100 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | 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 | 完整播放地址。 |
返回数据示例
示例：{"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"
}
]
}
]
}
更新记录
