github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-27 13:00:29 +08:00
Code Issues Packages Projects Releases Wiki Activity
167d4a6206
bilibili-API-collect/video/snapshot.md
SocialSisterYi 69ba9bea19
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00

14 KiB
Raw Blame History

视频快照

快照的截取时间根据视频画面变化程度决定，各视频不相同

截取时间表的时间根据视频画面变化程度决定，各每个视频不相同

截取时间表的时间和快照一一对应，并按照从左到右 从上到下的顺序排布

获取视频快照（web端）

https://api.bilibili.com/x/player/videoshot

请求方式：GET

url参数：

参数名 类型 内容 必要性 备注
aid num 稿件avid 必要（可选） avid与bvid任选一个
bvid str 稿件bvid 必要（可选） avid与bvid任选一个
cid num 分P cid 非必要 默认为1P
index num json数组截取时间表 非必要 1：需要
0：不需要
默认为0

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
40001：请求错误
40003：无视频
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

字段 类型 内容 备注
pvdata str bin格式截取时间表url
img_x_len num 每行图片数 一般为10
img_y_len num 每列图片数 一般为10
img_x_size num 每张图片长 一般为160
img_y_size num 每张图片宽 一般为90
image array 图片拼版
index array json数组格式截取时间表 无为空

data中的image数组：

项 类型 内容 备注
0 str 图片拼版1 url
n str 图片拼版(n+1) url 第一张拼版占满时延续第二张
…… str …… ……

data中的index数组：

项 类型 内容 备注
0 num 恒为0
1 num 图片1 截取时间 视频0秒截取时间
n num 图片n 截取时间 单位为秒
…… num …… 单位为秒

示例：

获取视频av26273789/BV1os411H7wm的快照

avid方式：

curl -G 'https://api.bilibili.com/x/player/videoshot' \
--data-urlencode 'aid=26273789' \
--data-urlencode 'index=1'

bvid方式：

curl -G 'https://api.bilibili.com/x/player/videoshot' \
--data-urlencode 'bvid=BV1os411H7wm' \
--data-urlencode 'index=1'
查看响应示例： 
{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"pvdata": "//i0.hdslb.com/bfs/videoshot/49075258.bin",
		"img_x_len": 10,
		"img_y_len": 10,
		"img_x_size": 160,
		"img_y_size": 90,
		"image": ["//i0.hdslb.com/bfs/videoshot/49075258.jpg", "//i0.hdslb.com/bfs/videoshot/49075258-1.jpg"],
		"index": [0, 0, 8, 14, 19, 25, 34, 40, 46, 56, 63, 70, 80, 87, 93, 100, 109, 117, 124, 133, 142, 148, 156, 164, 171, 179, 184, 192, 198, 206, 214, 223, 232, 239, 246, 254, 261, 269, 275, 283, 289, 299, 305, 310, 315, 322, 330, 339, 348, 358, 364, 371, 376, 382, 391, 404, 413, 421, 426, 434, 441, 452, 458, 463, 473, 479, 491, 497, 504, 514, 521, 528, 533, 540, 546, 552, 558, 567, 575, 586, 591, 602, 609, 615, 623, 629, 639, 647, 653, 658, 664, 670, 675, 684, 691, 698, 713, 724, 729, 737, 743, 754, 762, 772, 779, 784, 797, 803, 810, 817, 825, 834, 845, 851, 857, 867, 878, 888, 896, 903, 909, 914, 919, 928, 935, 944, 958, 970, 977, 988, 996, 1004, 1011, 1018, 1026, 1035, 1041, 1048, 1055, 1063, 1073, 1079, 1086, 1095, 1106, 1111, 1124, 1135, 1147, 1153, 1159, 1165, 1171, 1184, 1198, 1209, 1215, 1221, 1228, 1236, 1242, 1253, 1258, 1269, 1276, 1284, 1289, 1300, 1306, 1315, 1321, 1328, 1340, 1347, 1354, 1361, 1366, 1371, 1383, 1390, 1396, 1403, 1415]
	}
}

获取视频快照（APP端）

https://app.bilibili.com/x/v2/view/video/shot

请求方式：GET

鉴权方式：appkey

url参数：

参数名 类型 内容 必要性 备注
aid num 稿件avid 必要
appkey str APP密钥 APP方式必要
cid num 分P cid 必要
ts num 当前时间戳 APP方式必要
sign str APP签名 APP方式必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
10008：稿件的缩略图不存在
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

字段 类型 内容 备注
pvdata str bin格式截取时间表url
img_x_len num 每行图片数 一般为10
img_y_len num 每列图片数 一般为10
img_x_size num 每张图片长 一般为160
img_y_size num 每张图片宽 一般为90
image array 图片拼版

data中的image数组：

项 类型 内容 备注
0 str 图片拼版1 url
n str 图片拼版(n+1) url 第一张拼版占满时延续第二张
…… str …… ……

示例：

获取视频av26273789（cid=49075258）的快照

curl -G 'https://app.bilibili.com/x/v2/view/video/shot' \
--data-urlencode 'appkey=1d8b6e7d45233436' \
--data-urlencode 'aid=26273789' \
--data-urlencode 'cid=49075258' \
--data-urlencode 'ts=0' \
--data-urlencode 'sign=06c0a4f2ede21984313552bd9439db18'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "pvdata": "https://i0.hdslb.com/bfs/videoshot/49075258.bin",
        "img_x_len": 10,
        "img_y_len": 10,
        "img_x_size": 160,
        "img_y_size": 90,
        "image": [
            "https://i0.hdslb.com/bfs/videoshot/49075258.jpg",
            "https://i0.hdslb.com/bfs/videoshot/49075258-1.jpg"
        ]
    }
}

获取视频快照（web端）（用于封面预览）

https://api.bilibili.com/pvideo

请求方式：GET

内容与「获取视频快照1」加参数index=1相同，但url带有转义，仅限第1P

url参数：

参数名 类型 内容 必要性 备注
aid num 稿件avid 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
40001：请求错误
-404：无视频
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

字段 类型 内容 备注
pvdata str bin格式截取时间表url
img_x_len num 每行图片数 一般为10
img_y_len num 每列图片数 一般为10
img_x_size num 每张图片长 一般为160
img_y_size num 每张图片宽 一般为90
image array 图片拼版
index array json数组格式截取时间表 无为空

data中的image数组：

项 类型 内容 备注
0 str 图片拼版1 url
n str 图片拼版(n+1) url 第一张拼版占满时延续第二张
…… str …… ……

data中的index数组：

项 类型 内容 备注
0 num 恒为0
1 num 图片1 截取时间 视频0秒截取时间
n num 图片n 截取时间 单位为秒
…… num …… 单位为秒

示例：

获取视频av26273789的快照

curl -G 'https://api.bilibili.com/pvideo' \
--data-urlencode 'aid=26273789'
查看响应示例： 
{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"pvdata": "\/\/i0.hdslb.com\/bfs\/videoshot\/49075258.bin",
		"img_x_len": 10,
		"img_y_len": 10,
		"img_x_size": 160,
		"img_y_size": 90,
		"image": ["\/\/i0.hdslb.com\/bfs\/videoshot\/49075258.jpg", "\/\/i0.hdslb.com\/bfs\/videoshot\/49075258-1.jpg"],
		"index": [0, 0, 8, 14, 19, 25, 34, 40, 46, 56, 63, 70, 80, 87, 93, 100, 109, 117, 124, 133, 142, 148, 156, 164, 171, 179, 184, 192, 198, 206, 214, 223, 232, 239, 246, 254, 261, 269, 275, 283, 289, 299, 305, 310, 315, 322, 330, 339, 348, 358, 364, 371, 376, 382, 391, 404, 413, 421, 426, 434, 441, 452, 458, 463, 473, 479, 491, 497, 504, 514, 521, 528, 533, 540, 546, 552, 558, 567, 575, 586, 591, 602, 609, 615, 623, 629, 639, 647, 653, 658, 664, 670, 675, 684, 691, 698, 713, 724, 729, 737, 743, 754, 762, 772, 779, 784, 797, 803, 810, 817, 825, 834, 845, 851, 857, 867, 878, 888, 896, 903, 909, 914, 919, 928, 935, 944, 958, 970, 977, 988, 996, 1004, 1011, 1018, 1026, 1035, 1041, 1048, 1055, 1063, 1073, 1079, 1086, 1095, 1106, 1111, 1124, 1135, 1147, 1153, 1159, 1165, 1171, 1184, 1198, 1209, 1215, 1221, 1228, 1236, 1242, 1253, 1258, 1269, 1276, 1284, 1289, 1300, 1306, 1315, 1321, 1328, 1340, 1347, 1354, 1361, 1366, 1371, 1383, 1390, 1396, 1403, 1415]
	}
}

图片拼版

以160x90像素为一张，横向10张，纵向10张，从左到右从上到下进行裁剪

图1为0s，图2为8s，图3为14s，以此类推……

示例拼版图片url：http://i0.hdslb.com/bfs/videoshot/49075258.jpg

bin格式截取时间表

bin的内容为uint16数组（2Byte对齐），与json数组一一对应

第0项恒为0，从第1项开始作为截取图片的时间（秒）

示例bin格式截取时间表：http://i0.hdslb.com/bfs/videoshot/49075258.bin

hex内容如下：

00000000  00 00 00 00 00 08 00 0e  00 13 00 19 00 22 00 28  |.............".(|
00000010  00 2e 00 38 00 3f 00 46  00 50 00 57 00 5d 00 64  |...8.?.F.P.W.].d|
00000020  00 6d 00 75 00 7c 00 85  00 8e 00 94 00 9c 00 a4  |.m.u.|..........|
00000030  00 ab 00 b3 00 b8 00 c0  00 c6 00 ce 00 d6 00 df  |................|
00000040  00 e8 00 ef 00 f6 00 fe  01 05 01 0d 01 13 01 1b  |................|
00000050  01 21 01 2b 01 31 01 36  01 3b 01 42 01 4a 01 53  |.!.+.1.6.;.B.J.S|
00000060  01 5c 01 66 01 6c 01 73  01 78 01 7e 01 87 01 94  |.\.f.l.s.x.~....|
00000070  01 9d 01 a5 01 aa 01 b2  01 b9 01 c4 01 ca 01 cf  |................|
00000080  01 d9 01 df 01 eb 01 f1  01 f8 02 02 02 09 02 10  |................|
00000090  02 15 02 1c 02 22 02 28  02 2e 02 37 02 3f 02 4a  |.....".(...7.?.J|
000000a0  02 4f 02 5a 02 61 02 67  02 6f 02 75 02 7f 02 87  |.O.Z.a.g.o.u....|
000000b0  02 8d 02 92 02 98 02 9e  02 a3 02 ac 02 b3 02 ba  |................|
000000c0  02 c9 02 d4 02 d9 02 e1  02 e7 02 f2 02 fa 03 04  |................|
000000d0  03 0b 03 10 03 1d 03 23  03 2a 03 31 03 39 03 42  |.......#.*.1.9.B|
000000e0  03 4d 03 53 03 59 03 63  03 6e 03 78 03 80 03 87  |.M.S.Y.c.n.x....|
000000f0  03 8d 03 92 03 97 03 a0  03 a7 03 b0 03 be 03 ca  |................|
00000100  03 d1 03 dc 03 e4 03 ec  03 f3 03 fa 04 02 04 0b  |................|
00000110  04 11 04 18 04 1f 04 27  04 31 04 37 04 3e 04 47  |.......'.1.7.>.G|
00000120  04 52 04 57 04 64 04 6f  04 7b 04 81 04 87 04 8d  |.R.W.d.o.{......|
00000130  04 93 04 a0 04 ae 04 b9  04 bf 04 c5 04 cc 04 d4  |................|
00000140  04 da 04 e5 04 ea 04 f5  04 fc 05 04 05 09 05 14  |................|
00000150  05 1a 05 23 05 29 05 30  05 3c 05 43 05 4a 05 51  |...#.).0.<.C.J.Q|
00000160  05 56 05 5b 05 67 05 6e  05 74 05 7b 05 87        |.V.[.g.n.t.{..|