bilibili-API-collect/docs/video/summary.md
2024-01-24 22:32:52 +08:00

8.6 KiB
Raw Blame History

视频AI总结

获取AI总结内容

https://api.bilibili.com/x/web-interface/view/conclusion/get

请求方式: GET

鉴权方式:Wbi 签名

url参数

参数名 类型 内容 必要性 备注
aid num 稿件 avid 必要(可选) avid与bvid任选一个
bvid str 稿件 bvid 必要(可选) avid与bvid任选一个
cid num 视频 cid 必要
up_mid num UP主 mid 必要
w_rid str Wbi 签名 必要 详见 Wbi 签名
wts num 当前时间戳 必要 详见 Wbi 签名

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0: 成功
-400请求错误
-403: 访问权限不足
message str 错误信息 默认为0
ttl num 1
data obj 数据本体

data对象:

字段 类型 内容 备注
code num 返回值 -1: 不支持AI摘要敏感内容等或其他因素导致请求异常
0: 有摘要
1无摘要未识别到语音
model_result obj 摘要内容
stid str 摘要 id code=1且该字段为0时,则未进行 AI 总结,即添加总结队列
code=1且该字段为空时未识别到语音
status num (?)
like_num num 点赞数 默认为0
dislike_num num 点踩数 默认为0

data中的model_result对象:

字段 类型 内容 备注
result_type num 数据类型 0: 没有摘要
1仅存着摘要总结
2存着摘要以及提纲
summary str 视频摘要 通常为一段概括整个视频内容的文本
outline 有数据时array
无数据时null
分段提纲 通常为视频中叙述的各部分及其要点

model_result对象中的outline数组:

类型 内容 备注
0 obj 总结分段1
n obj 总结分段(n+1)
…… obj …… ……

outline数组中的对象:

字段 类型 内容 备注
title str 分段标题 段落内容的概括
part_outline array 分段要点 当前分段中多个提到的细节
timestamp num 分段起始时间 单位为秒

outline数组中的对象中的part_outline数组:

类型 内容 备注
0 obj 分段要点1
n obj 分段要点(n+1)
…… obj …… ……

part_outline数组中的对象:

字段 类型 内容 备注
timestamp num 要点起始时间 单位为秒
content str 小结内容 其中一个分段的要点

示例:

得到视频BV1L94y1H7CVcid=1335073288)的摘要

curl -G 'https://api.bilibili.com/x/web-interface/view/conclusion/get' \
  --data-urlencode 'bvid=BV1L94y1H7CV' \
  --data-urlencode 'cid=1335073288' \
  --data-urlencode 'up_mid=297242063' \
  --data-urlencode 'wts=1701546363' \
  --data-urlencode 'w_rid=1073871926b3ccd99bd790f0162af634'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "code": 0,
    "model_result": {
      "result_type": 2,
      "summary": "在网上阅读时遇到错别字和语言梗的烦恼,以及正确使用语言的重要性。作者认为,我们每个人都应该有包容心,不掉渣,不纠正别人的错误,同时也需要明辨是非,规范使用语言。视频还提到了一些常见的语言梗和错误用法,呼吁大家不要过分使用网络词汇,而应该注重语言的艺术性和深度。最后,作者欢迎大家关注他的微信公众号。",
      "outline": [
        {
          "title": "现代人使用中文时面临的困境,包括错别字、用法不正确等问题,并呼吁大家规范使用中文。",
          "part_outline": [
            {
              "timestamp": 1,
              "content": "网友评论有错别字,勉强能看懂,但难受。"
            },
            {
              "timestamp": 39,
              "content": "重来一次,明辨是非。"
            },
            {
              "timestamp": 167,
              "content": "粉墨登场是贬义词,形容坏人打扮好老登场。"
            }
          ],
          "timestamp": 1
        },
        {
          "title": "网络词汇的过度使用导致语言生硬,以及对流行语言梗的短暂使用感到厌倦。",
          "part_outline": [
            {
              "timestamp": 241,
              "content": "网络词汇过分使用会误导别人,使规范词汇生硬"
            },
            {
              "timestamp": 270,
              "content": "以前的语言梗有深度,现在的流行梗很短命"
            },
            {
              "timestamp": 338,
              "content": "巨星之间需要化学反应的过程,前几场发挥欠佳"
            }
          ],
          "timestamp": 241
        }
      ]
    },
    "stid": "5117037934391059183",
    "status": 0,
    "like_num": 6,
    "dislike_num": 2
  }
}

点赞&点踩摘要

https://api.bilibili.com/x/web-interface/view/conclusion/set

请求方式POST

认证方式Cookie(SESSDATA)

鉴权方式:Wbi 签名

url参数:

参数名 类型 内容 必要性 备注
w_rid str Wbi 签名 必要 详见 Wbi 签名
wts num 当前时间戳 必要 详见 Wbi 签名

正文参数( application/x-www-form-urlencoded ):

参数名 类型 内容 必要性 备注
aid num 稿件 avid 必要(可选) avid与bvid任选一个
bvid str 稿件 bvid 必要(可选) avid与bvid任选一个
cid num 稿件 cid 必要
up_mid num UP主 mid 非必要
stid num 摘要 id 必要
like_state num 执行操作 必要 1: 点赞
2: 取消点赞
3: 点踩
4: 取消点踩
csrf str CSRF Token位于cookie 必要

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0: 成功
-400: 请求错误
65002origin id 错误
65004取消赞失败 未点赞过
65005取消踩失败 未点踩过
65006: 已赞过
65007已踩过
message str 错误信息 默认为0
ttl num 1

示例:

为视频BV1L94y1H7CVcid=1335073288)的摘要点赞

curl 'https://api.bilibili.com/x/web-interface/view/conclusion/set?w_rid=edb471fc926646ef3889a80488166b66&wts=1700358953' \
  --data-urlencode 'bvid=BV1L94y1H7CV' \
  --data-urlencode 'cid=1335073288' \
  --data-urlencode 'up_mid=297242063' \
  --data-urlencode 'stid=5117037934391059183' \
  --data-urlencode '&like_state=1' \
  --data-urlencode 'csrf=xxx' \
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1
}