# 弹幕个人配置修改 | BAC Document
社区开源的第三方哔哩哔哩 API 文档

# 弹幕个人配置修改

## 修改弹幕个人配置（web端）

> https://api.bilibili.com/x/v2/dm/web/config

请求方式：POST

认证方式：Cookie（SESSDATA）或APP

正文参数（ application/x-www-form-urlencoded ）：

参数名 | 类型 | 内容 | 必要性 | 备注
--- | --- | --- | --- | ---
access_key | str | APP登录Token | APP方式必要 |
dm_switch | bool | 弹幕开关 | 非必要 | true：开启 false：关闭
blockscroll | bool | 屏蔽类型-滚动 | 非必要 | true：不屏蔽 false：屏蔽
blocktop | bool | 屏蔽类型-顶部 | 非必要 | 同上
blockbottom | bool | 屏蔽类型-底部 | 非必要 | 同上
blockcolor | bool | 屏蔽类型-彩色 | 非必要 | 同上
blockspecial | bool | 屏蔽类型-特殊 | 非必要 | 同上
ai_switch | bool | 是否打开智能云屏蔽 | 非必要 | true：开启 false：关闭
ai_level | num | 智能云屏蔽等级 | 非必要 | 区间：[0-10] 0为默认等级（3级）
preventshade | bool | 防挡弹幕（底部15%） | 非必要 | true：开启 false：关闭
dmask | bool | 智能防挡弹幕（人像蒙版） | 非必要 | 同上
opacity | num | 弹幕不透明度 | 非必要 | 区间：[0-1]
dmarea | num | 弹幕显示区域 | 非必要 | 100：不重叠 75：3/4屏 50：半瓶 25：1/4屏 0：不限
speedplus | num | 弹幕速度 | 非必要 | 区间：[0.4-1.6]
fontsize | num | 字体大小 | 非必要 | 区间：[0.4-1.6]
screensync | bool | 跟随屏幕缩放比例 | 非必要 | true：开启 false：关闭
speedsync | bool | 根据播放倍速调整速度 | 非必要 | 同上
fontfamily | str | 字体类型 | 非必要 | 未启用
bold | bool | 粗体 | 非必要 | 未启用
fontborder | num | 描边类型 | 非必要 | 0：重墨 1：描边 2：45°投影
drawType | string | 渲染类型 | 非必要 | 未启用
ts | num | 当前时间戳 | 非必要 |
csrf | str | CSRF Token（位于cookie） | Cookie方式必要 |

json回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 | 0：成功 -101：账号未登录 -111：csrf校验失败 -400：请求错误 23004：数据没有修改
message | str | 错误信息 | 默认为0
ttl | num | 1 |

示例：

关闭弹幕

    curl 'https://api.bilibili.com/x/v2/dm/web/config' \
    --data-urlencode 'dm_switch=false' \
    --data-urlencode 'csrf=xxx' \
    -b 'SESSDATA=xxx'

查看响应示例：

    {
        "code":0,
        "message":"0",
        "ttl":1
    }