内容安全
什么都没改,请求却突然全部失败?多半是内容安全规则暂时暂停了你的调用。这篇文档讲清楚三件事:什么会触发它、暂停多久、接下来该做什么。
内容安全审核是什么
你通过 OfoxAI 发出的每个请求,最终都会到达上游供应商(OpenAI、Anthropic、Google 等)运行的模型。这些供应商会按各自的使用政策检查收到的文字、图片和文件,不符合的直接拒绝。OfoxAI 在这之上多加了一层:当一个账号持续发出被拒绝的请求,平台会暂停这个账号的调用一段时间,而不是继续把请求转发上去。
这个暂停保护两件事:你的账号在上游供应商那里的信誉,以及所有 OfoxAI 用户共用的调用通道。
它和速率限制不是一回事
| 速率限制 | 内容安全暂停 | |
|---|---|---|
| 触发原因 | 请求发得太快 | 请求里装的是什么内容 |
| 你看到的现象 | 429 Too Many Requests | 请求被判定违反政策而拒绝 |
| 怎么解决 | 放慢速度再重试 | 找出被判定的内容并改掉 |
| 持续多久 | 几秒 | 5 分钟到 12 小时 |
正常业务为什么也会被判定
被拒绝的内容分两类:一类确实违反了供应商的使用政策或 OfoxAI 服务条款 ,另一类是自动分类器判错了。让人意外的基本都属于第二类。
最常见的几种情况:
- 对被拒绝的请求反复重试。脚本收到一次拒绝,把同一段内容又重试了四次,一次判定就变成五次。这是最快撞上下面第一档阈值的方式。
- 批量处理不是自己写的内容。爬来的网页、用户评论、客服记录、PDF 里,夹着没人逐条看过的内容。
- 直接透传最终用户的输入。只要产品把访客输入原样发给模型,早晚会有人输入被判定的内容。
- 很长的多轮对话。每一轮都会把完整历史重新发给模型,一条被判定的消息只要不删,就会一直重复计数。
- 误判。人像照片、医疗问题、安全研究、小说情节都可能被读错。而且不同供应商的口径并不一致,同一份素材在 A 模型被拒,在 B 模型可能正常通过。
单次请求被拒绝不是处罚,把这一条改掉就行。只有短时间内被拒绝的次数堆起来,才会触发暂停。
阶梯规则
两件事决定后果:短时间内累计了多少次判定,以及这个账号之前被暂停过几次。
触发暂停的阈值
判定次数按滑动窗口统计,达到其中任意一条就会触发暂停:
| 统计窗口 | 触发次数 |
|---|---|
| 1 分钟 | 5 次 |
| 5 分钟 | 15 次 |
| 30 分钟 | 30 次 |
每次暂停多久
再次触发会逐级加长:
| 第几次暂停 | 暂停时长 |
|---|---|
| 第 1 次 | 5 分钟 |
| 第 2 次 | 15 分钟 |
| 第 3 次 | 1 小时 |
| 第 4 次 | 4 小时 |
| 第 5 次 | 12 小时 |
一个典型过程:批量任务 1 分钟内被判定 5 次,暂停 5 分钟;数据没清理就重跑,又被判定 5 次,这次暂停 15 分钟。打断这个循环的关键,是在第一次暂停期间就把数据处理掉。
暂停期间,相关请求会在网关侧被直接拒绝,不会发给模型,也不会产生费用。时间一到自动恢复,不需要联系任何人,也不需要额外操作。
累犯计数不会跟你一辈子:一段时间不再触发,下次就会从第 1 级重新开始。如果在最长一级之后仍然反复触发,账号会转入人工审核,依据服务条款 可能被限制或中止服务。
另注册账号、或者新建一个 API Key 来规避暂停,属于违反服务条款,不是解决办法。确实等不了,请直接联系客服。
该怎么处理
已经被暂停了
- 先停下来。暂停任务,关掉自动重试。重试不会让暂停提前结束。
- 找出被判定的请求。打开控制台 的 日志(Logs) 页面,按第一次失败前后的时间筛选,找被拒绝的那些请求。
- 改掉源头。删掉或改写这些内容,并确认重试逻辑、任务队列不会把同样的输入再发一遍。
- 等时间到。到点自动恢复。
- 小批量重启。先发几条确认没问题,再放开整批任务。
怎么避免再次触发
- 一条内容被拒绝,就当它对这个输入是最终答案:记下来、跳过去,不要循环重试。
- 面向公众的产品,用户输入在发给模型之前先做一道过滤。
- 导入或爬取的数据,大批量跑之前先人工抽检。
- 长对话里把被判定的那几轮删掉,而不是把完整历史一直重发。
- 不同业务用不同的 API Key,出问题时在日志里一眼能看出是哪个任务。
如果觉得是误判
分类器确实会判错。发邮件到 support@ofoxai.com,写清楚:
- 账号邮箱
- 请求被拦的时间(注明时区)
- 调用的模型
- 日志页面里的一两个请求 ID
不要在邮件里附上 API Key、密码,也不要贴超出排查需要的客户数据。我们会核对触发原因,并在可说明的范围内把结果告诉你。
你可能收到的邮件
账号被限制时,OfoxAI 可能会给注册邮箱发一封通知。真实的通知来自 OfoxAI 的邮箱地址(@ofoxai.com 或 @ofox.ai),会写明是哪个账号、限制了什么、持续多久、该去查什么。
收到之后:
- 自己打开控制台登录,不要直接点邮件里的链接,再按邮件里的时间去查 日志 页面。
- 先把内容改掉再重启任务。邮件只是告诉你发生了什么,不会替你把限制去掉。
- 认为判错了,直接回复这封邮件,或者写信到 support@ofoxai.com。
OfoxAI 绝不会向你索要:
- API Key、密码或验证码
- 任何形式的“恢复服务费用”
- 把沟通转到私人邮箱或聊天软件
只要对方索要以上任何一项,不管发件人写的是谁,都是钓鱼邮件。转发到 support@ofoxai.com,然后删掉它。