视频快照

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

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

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

获取视频快照（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.{..|

# 视频快照

# 获取视频快照（web端）

# 获取视频快照（APP端）

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

# 图片拼版

# bin格式截取时间表

视频快照

获取视频快照（web端）

获取视频快照（APP端）

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

图片拼版

bin格式截取时间表