返回提交历史
Modified
docs/video/summary.md
+71
-147
XFEstudio/bilibili-API-collect
修改 APIDoc【AI总结】
852953d
代码差异
1 个文件
+71
-147
@@ -1,24 +1,12 @@
1
**# 视频AI总结**
2
3
1
# 视频AI总结
4
2
5
3
<img src="../../assets/img/aiSummary.svg" width="100" height="100"/>
6
4
7
8
9
**## 获取总结**
10
11
5
## 获取AI总结内容
12
6
13
7
> https://api.bilibili.com/x/web-interface/view/conclusion/get
14
8
15
16
17
**请求方式: Get**
18
19
认证方式: Cookie(SESSDATA)
20
21
限制游客访问，需要登录
9
*请求方式: GET*
22
10
23
11
鉴权方式：[Wbi 签名](../misc/sign/wbi.md)
24
12
@@ -26,9 +14,10 @@
26
14
27
15
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
28
16
|--------|-----|--------|-----|----------------------------------|
29
| bvid | str | 稿件bvid | 必要 | |
30
| cid | num | 稿件cid | 必要 | |
31
| up_mid | num | UP主mid | 必要 | |
17
| aid | num | 稿件 avid | 必要(可选) | avid与bvid任选一个 |
18
| bvid | str | 稿件 bvid | 必要(可选) | avid与bvid任选一个 |
19
| cid | num | 视频 cid | 必要 | |
20
| up_mid | num | UP主 mid | 非必要 | |
32
21
| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
33
22
| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
34
23
@@ -38,7 +27,7 @@
38
27
39
28
| 字段 | 类型 | 内容 | 备注 |
40
29
|---------|-----|------|--------------------------|
41
| code | num | 返回值 | 0: 成功<br /> -403: 访问权限不足 |
30
| code | num | 返回值 | 0: 成功<br />-400：请求错误<br /> -403: 访问权限不足 |
42
31
| message | str | 错误信息 | 默认为0 |
43
32
| ttl | num | 1 | |
44
33
| data | obj | 数据本体 | |
@@ -47,74 +36,65 @@
47
36
48
37
| 字段 | 类型 | 内容 | 备注 |
49
38
|--------------|-----|------|----------------------|
50
| code | num | 返回值 | 0: 有摘要<br />-1: 没有摘要 |
39
| code | num | 返回值 | -1: 不支持AI摘要（敏感内容）<br />0: 有摘要<br />1：无摘要（未识别到语音） |
51
40
| model_result | obj | 摘要内容 | |
41
| stid | str | 摘要 id | 如`code=1`且该字段为`0`时，则未进行 AI 总结，即添加总结队列<br />如`code=1`且该字段为空时未识别到语音 |
42
| status | num | (?) | |
43
| like_num | num | 点赞数 | 默认为`0` |
44
| dislike_num | num | 点踩数 | 默认为`0` |
52
45
53
`model_result`对象:
46
`data`中的`model_result`对象:
54
47
55
48
| 字段 | 类型 | 内容 | 备注 |
56
49
|-------------|-----|----------|------------------------------------------|
57
| result_type | num | 数据类型 | 0: 没有摘要或者没有时间线<br />2: 有时间线<br />(1暂不知晓) |
58
| summary | str | 整个视频总结 | |
59
| outline | obj | 时间线 | 没有时间线为None |
60
| like_num | num | 喜欢人数 | |
61
| dislike_num | num | 不喜欢人数 | |
62
| stid | num | 摘要id | 没有摘要为0 |
63
| status | num | 状态(暂不知晓) | 正常为0 |
50
| result_type | num | 数据类型 | 0: 没有摘要<br />1：仅存着摘要总结<br />2：存着摘要以及提纲 |
51
| summary | str | 视频摘要 | 通常为一段概括整个视频内容的文本 |
52
| outline | 有数据时：array<br />无数据时：null | 分段提纲 | 通常为视频中叙述的各部分及其要点 |
64
53
65
`outline`对象:
54
`model_result`对象中的`outline`数组:
66
55
67
| 字段 | 类型 | 内容 | 备注 |
68
|--------------|-----|------|----|
69
| title | str | 分段标题 | |
70
| part_outline | obj | 分段小结 | |
56
| 项 | 类型 | 内容 | 备注 |
57
|-----|-----|---------|-----|
58
| 0 | obj | 总结分段1 | |
59
| n | obj | 总结分段(n+1) | |
60
| …… | obj | …… | …… |
71
61
72
`part_outline`对象:
62
`outline`数组中的对象:
73
63
74
| 字段 | 类型 | 内容 | 备注 |
75
|-----------|-----|-------|----|
76
| timestamp | num | 小结时间戳 | |
77
| content | str | 小结内容 | |
78
79
**示例**
64
| 字段 | 类型 | 内容 | 备注 |
65
|--------------|-----|------|----|
66
| title | str | 分段标题 | 段落内容的概括 |
67
| part_outline | array | 分段要点 | 当前分段中多个提到的细节 |
68
| timestamp | num | 分段起始时间 | 单位为秒 |
80
69
81
得到视频`BV1L94y1H7CV`的摘要
70
`outline`数组中的对象中的`part_outline`数组:
82
71
83
```shell
84
curl 'https://api.bilibili.com/x/web-interface/view/conclusion/get?bvid=BV1L94y1H7CV&cid=1335073288&up_mid=297242063&web_location=333.788&w_rid=d76ea8eaa47b3c9f0c4a910a8b9b66f5&wts=1700358732' \
85
--compressed
86
```
72
| 项 | 类型 | 内容 | 备注 |
73
|-----|-----|---------|-----|
74
| 0 | obj | 分段要点1 | |
75
| n | obj | 分段要点(n+1) | |
76
| …… | obj | …… | …… |
87
77
88
<details>
89
<summary>查看Python Demo</summary>
78
`part_outline`数组中的对象:
90
79
91
```python
92
import requests
80
| 字段 | 类型 | 内容 | 备注 |
81
|-----------|-----|-------|----|
82
| timestamp | num | 要点起始时间 | 单位为秒 |
83
| content | str | 小结内容 | 其中一个分段的要点 |
93
84
94
headers = {
95
# 需要附带上Cookie等信息
96
'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36',
97
}
85
**示例：**
98
86
99
params = {
100
'bvid': 'BV1d94y1375U',
101
'cid': '1334003541',
102
'up_mid': '407275913',
103
'w_rid': '5cafe844afcb813ecd129f08e6ea73b5', # 参见Wbi签名章节
104
'wts': '1700579155',
105
}
87
得到视频`BV1L94y1H7CV`（`cid=1335073288`）的摘要
106
88
107
response = requests.get(
108
'https://api.bilibili.com/x/web-interface/view/conclusion/get',
109
params=params,
110
headers=headers,
111
)
89
```bash
90
curl -G 'https://api.bilibili.com/x/web-interface/view/conclusion/get' \
91
--data-urlencode 'bvid=BV1L94y1H7CV' \
92
--data-urlencode 'cid=1335073288' \
93
--data-urlencode 'up_mid=297242063' \
94
--data-urlencode 'wts=1701546363' \
95
--data-urlencode 'w_rid=1073871926b3ccd99bd790f0162af634'
112
96
```
113
97
114
</details>
115
116
有摘要示例:
117
118
98
<details>
119
99
<summary>查看响应示例：</summary>
120
100
@@ -169,50 +149,25 @@ response = requests.get(
169
149
},
170
150
"stid": "5117037934391059183",
171
151
"status": 0,
172
"like_num": 3,
173
"dislike_num": 0
152
"like_num": 6,
153
"dislike_num": 2
174
154
}
175
155
}
176
156
```
177
157
178
158
</details>
179
159
180
无摘要示例:
181
182
<details>
183
<summary>查看响应示例：</summary>
184
185
```json
186
{
187
"code": 0,
188
"message": "0",
189
"ttl": 1,
190
"data": {
191
"code": 1,
192
"model_result": {
193
"result_type": 0,
194
"summary": "",
195
"outline": None
196
},
197
"stid": "0",
198
"status": 0,
199
"like_num": 0,
200
"dislike_num": 0
201
}
202
}
203
```
160
## 点赞&点踩摘要
204
161
205
</details>
162
> https://api.bilibili.com/x/web-interface/view/conclusion/set
206
163
207
## 点赞&点踩摘要(对应上面link_num&dislike_num)
164
*请求方式：POST*
208
165
209
166
认证方式：Cookie(SESSDATA)
210
167
211
限制游客访问，需要登录
212
213
168
鉴权方式：[Wbi 签名](../misc/sign/wbi.md)
214
169
215
***\*url参数:\****
170
**url参数:**
216
171
217
172
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
218
173
|-------|-----|--------|-----|----------------------------------|
@@ -221,13 +176,14 @@ response = requests.get(
221
176
222
177
**正文参数( application/x-www-form-urlencoded ):**
223
178
224
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
179
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
225
180
|------------|-----|----------------------|-----|-----------------------------|
226
| bvid | str | 稿件bvid | 必要 | |
227
| cid | num | 稿件cid | 必要 | |
228
| up_mid | num | UP主mid | 必要 | |
229
| stid | num | 摘要id | 必要 | |
230
| like_state | num | 喜欢状态 | 必要 | 1: 点赞<br />2: 取消<br />3: 点踩 |
181
| aid | num | 稿件 avid | 必要(可选) | avid与bvid任选一个 |
182
| bvid | str | 稿件 bvid | 必要(可选) | avid与bvid任选一个 |
183
| cid | num | 稿件 cid | 必要 | |
184
| up_mid | num | UP主 mid | 非必要 | |
185
| stid | num | 摘要 id | 必要 | |
186
| like_state | num | 执行操作 | 必要 | 1: 点赞<br />2: 取消点赞<br />3: 点踩<br />4: 取消点踩 |
231
187
| csrf | str | CSRF Token（位于cookie） | 必要 | |
232
188
233
189
**json回复：**
@@ -236,57 +192,25 @@ response = requests.get(
236
192
237
193
| 字段 | 类型 | 内容 | 备注 |
238
194
|---------|-----|------|------------------------------------------|
239
| code | num | 返回值 | 0: 成功 <br />-400: 请求错误<br />65006: 已赞/踩过 |
195
| code | num | 返回值 | 0: 成功 <br />-400: 请求错误<br />65002：origin id 错误<br />65004：取消赞失败 未点赞过<br />65005：取消踩失败 未点踩过<br />65006: 已赞过<br /> 65007：已踩过 |
240
196
| message | str | 错误信息 | 默认为0 |
241
197
| ttl | num | 1 | |
242
198
243
199
**示例：**
244
200
245
为视频`BV1L94y1H7CV`的摘要`5117037934391059183`点赞
201
为视频`BV1L94y1H7CV`（`cid=1335073288`）的摘要点赞
246
202
247
203
```shell
248
204
curl 'https://api.bilibili.com/x/web-interface/view/conclusion/set?w_rid=edb471fc926646ef3889a80488166b66&wts=1700358953' \
249
--data-raw 'bvid=BV1L94y1H7CV&cid=1335073288&up_mid=297242063&stid=5117037934391059183&like_state=1&csrf=522xxxxxxxxxxxxxxx6f4' \
250
--compressed
251
```
252
253
<details>
254
<summary>查看Python Demo</summary>
255
256
```python
257
import requests
258
259
headers = {
260
# 需要附带上Cookie等信息
261
'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36',
262
}
263
264
params = {
265
'w_rid': 'edb471fc926646ef3889a80488166b66',
266
'wts': '1700358953',
267
}
268
269
data = {
270
'bvid': 'BV1L94y1H7CV',
271
'cid': '1335073288',
272
'up_mid': '297242063',
273
'stid': '5117037934391059183',
274
'like_state': '1',
275
'csrf': '522xxxxxxxxxxxxxxx6f4',
276
}
277
278
response = requests.post(
279
'https://api.bilibili.com/x/web-interface/view/conclusion/set',
280
params=params,
281
data=data
282
)
283
205
--data-urlencode 'bvid=BV1L94y1H7CV' \
206
--data-urlencode 'cid=1335073288' \
207
--data-urlencode 'up_mid=297242063' \
208
--data-urlencode 'stid=5117037934391059183' \
209
--data-urlencode '&like_state=1' \
210
--data-urlencode 'csrf=xxx' \
211
-b 'SESSDATA=xxx'
284
212
```
285
213
286
</details>
287
288
289
290
214
<details>
291
215
<summary>查看响应示例：</summary>
292
216