New API rc.50 上线插件市场!敏感词改为请求过滤

New API版本发布 · V1.0.0-rc.50

敏感词列表里有一条「内部代号X」，用户发来一句「请帮我解释一下内部代号x是什么」。旧版本返回 HTTP 500，错误码 sensitive_words_detected；换成 v1.0.0-rc.50 后，同一句话返回 HTTP 400，错误码 request_rejected，信息是 Request rejected by policy (code: request_filtered)。

如果你的客户端按错误码或 500 状态码做判断，升级后要跟着改。

原因是这版最大的改动：New API 有了插件，敏感词搬进了新的「请求处理」。

建议升级 想用插件扩展功能的站长，以及同一个站跑在多台服务器上的站长，建议尽快升级。 升级前必看 3 件事：

1. 敏感词命中后的错误码变了，从 500 sensitive_words_detected 改为 400 request_rejected。
2. 已结束的系统任务每天自动清理，默认只保留 30 天。
3. Vertex AI 的视频请求改发到渠道（你在 New API 里接入的一个模型服务商账号）填写的部署地区，不再固定发到 global。

75 秒看完这版的重点（界面数据为模拟值）

这版改了什么？5 件事一张清单

1. 新增插件：提供商插件、请求处理插件和插件市场。
2. 敏感词自动迁成「请求过滤」，命中返回 400 request_rejected（原来是 500 sensitive_words_detected）。
3. 多节点部署时，后台手动改的设置几秒内同步到所有节点。
4. 已结束的系统任务默认保留 30 天。
5. Vertex AI 插件 1.3.1 的视频请求改发到渠道填写的部署地区。

后文会用到两个词：

• 上游：模型服务商。
• 多节点：同一个站跑在好几台服务器上。

插件是什么？给 New API 装上的功能模块

插件是不改程序本体、按需装上的功能模块。升级后，后台侧边栏多了「插件」和「请求处理」两个菜单。插件页的「已安装」分为「任务 / 渠道 / 请求处理」三类。

✦提供商插件：用插件接入新的上游厂商

• 解决什么问题：不改程序本体，就能把一个新的上游厂商接进来。
• 能做什么：把一个上游厂商接成一种渠道类型，可以包含路由、协议转换、模型列表、需要登录的上游（登录与令牌刷新）、余额查询和定时维护。
• 适合谁：需要接入新上游的站长。

✦请求处理插件：在请求和回复上加规则

• 解决什么问题：给请求和回复做过滤、脱敏、改参数这类处理。
• 现在怎么做：请求处理插件在请求和回复上运行，可以按全局、分组、渠道和模型生效。规则可以先试运行，每处修改都会记进使用日志。
• 在哪里打开：侧边栏「插件」→「已安装」→「请求处理」标签。

下图就是这个标签页，6 张卡片对应 6 个内置插件，每张卡片都标了它在哪个阶段运行。页面上还能看到「插件市场」标签和「启用插件」开关。

插件页「请求处理」标签下的 6 个内置插件

✦插件市场：官方和社区两个来源

插件页的「插件市场」标签里有「官方插件」和「社区插件」两个来源。两类插件都能按 8 位插件码安装，安装时会显示使用说明和更新日志。

插件下载站点可以选主站或备用站，我们实测时选中的是「主站（www.newapi.ai）」。^[1]

我的敏感词还在吗？ 在，搬到了「请求处理」里

首次启动 rc.50 时，原来的「敏感词」设置会自动迁成一个「请求过滤」实例，名称是「敏感词」，适用范围是「所有请求」，旧的设置项随之删除。启动日志里会出现这一行：

moved the sensitive words to the global request filter instance 敏感词

「实例」指的是一个插件配好一份规则后的那一条，比如一份敏感词列表。

打开侧边栏「请求处理」页，列表里「敏感词 / 请求过滤 / 所有请求 / 已启用」这一行，就是你原来的敏感词。

升级后，原来的敏感词变成了「请求处理」页里的一个请求过滤实例

迁移后的状态：

• 原来同时开了「检查敏感词」和「检查提示词」的，迁过来的实例是启用状态。
• 词表原样保留，仍然不区分大小写，所以「内部代号x」会命中「内部代号X」。

页面顶部写明了执行顺序：「实例从上到下运行：先运行对所有请求生效的实例，再运行请求所在分组的实例，最后运行渠道添加的实例。」

**回滚到旧版本后，敏感词检查是关闭的，需要重新填写。**所以升级前请先把敏感词列表复制保存一份。

怎么知道规则会不会误伤？可以先点「试运行」

规则上线前，可以用试运行先确认正常请求不会被误拒。

操作步骤：

1. 打开侧边栏「请求处理」页，点右上角的「试运行」。
2. 填一段示例请求体。
3. 点「运行」。

试运行的完整操作（界面数据为模拟值）

下图的请求体里含有「内部代号X」，红字结果是「被 敏感词 拒绝：（代码：request_filtered）」，表格中阶段为「读取请求前」，操作为「拒绝」。

试运行结果：含敏感词的请求在「读取请求前」被拒绝

结果表格会列出实例、阶段、操作、修改数、命中和耗时。表格下方还会显示请求体是否被改、请求头变更，以及「用户在日志中看到的内容」。脱敏、参数覆盖这类会改动请求的规则，也可以靠这些信息核对效果。

多节点和运维有什么变化？手动改动几秒内同步到所有节点

• 设置、权限、插件、登录方式、模型、订阅套餐和渠道的手动改动，几秒内在所有节点生效。系统信息页能看到同步进度和加载失败的节点。
• CHANNEL_UPDATE_FREQUENCY 的定时余额更新改为只在主节点运行。
• 「更新全部余额」改成后台任务，列表随进度刷新。
• 已结束的系统任务每天自动清理，默认保留 30 天。要保留更久，在「系统设置 → 运维 → 日志维护」里修改保留天数。

还改了什么？计费、支付和 4 项修复

改进：

• Vertex AI 插件 1.3.1：视频请求发到渠道填写的部署地区，不再固定发到 global。升级前确认所用视频模型在该地区可用。
• 图片计费：张数按最终发给上游的请求计算，包括 SiliconFlow 的 batch_size、Imagen 的 sampleCount（不填按 4 张算）、Replicate 的 num_outputs。插件或渠道覆盖改了张数时，预扣也会跟着变。
• 易支付的签名方式可以选 MD5 或 RSA。
• 新增 HOST 环境变量，用来设置监听地址。
• DeepSeek 渠道的 Chat Completions 请求会把 developer 角色转成 system。

已修复的问题：

• 透传请求重试时，新渠道可能收到残缺的请求体。
• 切换渠道后，模型重定向同步会把上一个渠道的模型名加进当前渠道。
• 用输入法输入风险确认文字后，按钮仍然不可用。
• 登录页的协议同意文字没有翻译，现在会翻译。

怎么升级？先做完这 5 件事再换版本

升级前清单：

1. 备份数据库。
2. 复制保存一份敏感词列表。
3. 检查客户端是否依赖 500 或 sensitive_words_detected，改为识别 400 和 request_rejected。
4. 系统任务需要保留超过 30 天的，先到「系统设置 → 运维 → 日志维护」修改保留天数。
5. 使用 Vertex AI 视频的，确认所用视频模型在渠道的部署地区可用。

获取方式：在 GitHub 搜索 QuantumNous/new-api，打开 Releases 页面，找到 v1.0.0-rc.50 下载。

Docker 用户把镜像换成 calciumion/new-api:v1.0.0-rc.50：

docker pull calciumion/new-api:v1.0.0-rc.50

升级后验证：打开「请求处理」页，确认「敏感词」实例存在，状态和你原来的设置一致。再点「试运行」，用一条含敏感词的请求测试，确认它会被拒绝。

— END —

New API 词元基座

Connect every AI.

One foundation.

承载 AI 应用 · 连接未来

欢迎「点赞」「转发」「小心心」

留言聊聊 →

QuantumNous/new-api  ·  www.newapi.ai