> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# B站读取遇到412、-352或密匙错误，怎样接着做视频研究？

> 保留已选视频和原评论，按BV/AV对象补研究缺口，分清平台状态、网页签名与BeatAPI鉴权，交付实际发现与未完成项。

**把已选的视频和已读评论保留下来，列出还缺哪一页或哪段上下文，再用 `bilibili.web.fetch_video_comments` 或 `bilibili.app.fetch_video_comments` 只补这个缺口。** 原程序出错不需要把所有搜索与整理工作推倒重来。HTTP 412、`-352` 和 `-3` 来自原来的 B 站请求或客户端；调用 BeatAPI 只需要 BeatAPI API Key、BV 号和页码。

例如剪辑课程团队已选好几条同类视频，部分热门评论已存，继续读取时中断。先保留 BV 号、视频选择理由、评论原句和未答问题，再决定要补最新评论、回复上下文，还是更多同主题视频。

## 先确认你要恢复哪部分

| 已有进度          | 下一步                  |
| ------------- | -------------------- |
| 视频清单已确认，原件可读  | 先继续课程讲法与问题分析         |
| 有准确BV号，评论未读   | 对该视频取首批评论            |
| 已存一级评论，问题有歧义  | 确认父评论标识，再补回复         |
| 原分页状态无法确认     | 保留已读范围，从新首批建观察，再核对重叠 |
| 只有UP主mid或未知短码 | 先定位视频，不把账号编号当作品编号    |

定位步骤见[BV/AV说明](/zh/faq/bilibili-bv-comments)。旧采集程序的游标、签名和缓存字段不是 BeatAPI 动作的输入。

## 已有BV号，可以怎样补读？

用 `bilibili.web.fetch_video_comments` 读取 Web 评论首页：

```json
{
  "action": "bilibili.web.fetch_video_comments",
  "params": {"bv_id": "<confirmed_bv_id>", "pn": 1}
}
```

请求发到 `POST https://api.beatapi.io/v1/social-data/call`，使用常规 BeatAPI Bearer 鉴权。需要明确选择最新或热门时，改用 `bilibili.app.fetch_video_comments`，按[排序说明](/zh/faq/bilibili-comment-order)设置。Web 和 App 的结果分开保存，不要把旧排序或旧游标传给新动作。

每份真实返回都保存视频标识、动作、实际输入、查询时间和请求号。评论动作还没有登记固定的列表与标识路径，合并材料前先核对实际返回的对象，不要沿用旧解析器或别家的统一字段。

## 412、-352 和 -3 各该查哪里？

先看出错请求发给了哪个服务，再看 HTTP 状态和响应正文。把两项分开记，方便自己重查或交给维护同事。

| 看到的提示                     | 先做什么                                                 |
| ------------------------- | ---------------------------------------------------- |
| 原 B 站直连请求返回 HTTP 412      | 记下原请求状态，把那一页标为待读                                     |
| 原响应里的 `-352` 或「风控校验失败」    | 保存实际提示，记清当时读的是哪个视频或账号                                |
| 旧客户端显示 `-3` 或「API 校验密匙错误」 | 核对客户端版本和维护者说明                                        |
| 自己发给 BeatAPI 的调用报鉴权错误     | 检查该请求的 `Authorization: Bearer` 是否配置了 BeatAPI API Key |

`wbi`、`appkey` 和 `sign` 属于原来的网页或客户端请求，不属于 BeatAPI。用 `bilibili.web.fetch_video_comments` 继续时，准备 BeatAPI API Key、BV 号和所需页码即可。

## 新旧材料怎样对照？

1. 新旧材料按已确认的视频身份（BV 号或已确认的作品关系）关联。
2. 评论按实际稳定的评论标识核对重复。
3. 保留每次观察，不用新值覆盖旧原文。
4. 版本、查询时间或排序不同时，写清差异。

答疑表里分开列：已有原句支持的问题、待补条件、未读评论、读取失败。比如“新版没有此菜单”已经有原句，就可以先交给团队核对版本；没读成功的视频仍留在待办里，不能记作没有问题。

## 恢复后交付什么？

先交付有依据的课程改进及其原句和来源，再附未完成的视频、回复和下一步。重复内容不计作新的学员；每次补读是否带来新条件或新问题，也写进记录。

给助手可以这样交代：

> 接着这轮B站课程研究做，先复用选中视频和已存评论。按具体缺口补读，不重做全部搜索。每个答疑或课程改进附原句和来源；分页状态不明的另建观察，说明新材料与旧材料的关系及剩余待办。

只为缺口估算查询费用，当前价格见[价格页](https://beatapi.io/zh/pricing)。重新分类或重读已存材料不需要重发请求。