错误与拒答/违规处置费与限制
违规处置费与风控限制
请求被上游判定违反使用政策时,会给提供模型的账号带来封号风险。Wokey 对这类请求收取违规处置费,反复触发还会限制相关模型或账号。
概要link
- 只有上游明确以使用政策为由拒绝的请求才收费,例如 Claude 拒答、内容审核拒绝。普通报错、超时、限流和参数错误都不收费。
- 每次收取一笔固定的违规处置费,基础金额 $0.10;请求已经产生的模型用量照常计费。
- 偶尔触发一次只收费,不影响使用。同一模型短时间内反复触发,才会限流或暂停这个模型;多个模型先后被暂停,会暂停整个账号的模型调用。
哪些情况会收费link
| 情形 | 你收到的响应 | 计入限制 |
|---|---|---|
| Claude 模型拒答 | HTTP 200,stop_reason 为 "refusal"(Chat Completions 格式为 finish_reason "content_filter") | 是 |
| 上游内容审核拒绝(火山方舟、xAI 等) | HTTP 4xx,错误码如 InputTextSensitiveContentDetected、SensitiveContentDetected | 是 |
| OpenAI 网络安全策略拦截 | 错误码 cyber_policy | 否,只收费 |
| Claude 输出被内容过滤 | HTTP 400,Output blocked by content filtering policy | 否,只收费 |
收费规则link
- 基础金额 $0.10 / 次,和模型用量一样按你账户的价格调整(加价或折扣)计算,实际扣费以调用记录为准。
- 如果请求在被拒绝前已经产生了输入或输出 token,这部分按正常价格计费,违规处置费另外收取。
- 近 30 天在 GPT 系列模型上累计触发 30 次及以上的账户,违规处置费为 2 倍(基础 $0.20),对所有模型生效。名单每天更新,次数回落后自动恢复。
- 在控制台「调用记录」里,这类请求显示为失败。鼠标悬停在失败图标上会显示「已收取 $x 违规处置费」,点开金额可以看到违规处置费明细。
反复触发后的限制link
- 1
单次触发
只收违规处置费,不影响后续请求。
- 2
同一模型短时间内反复触发
这个模型临时限流:你的账户在该模型上最多同时 1 个请求、每分钟 10 个请求,超出返回 HTTP 429 rate_limit_exceeded。其他模型不受影响。一段时间内不再触发会自动解除,通常 1–2 小时。
- 3
限流期间继续触发
这个模型暂停 24 小时,请求返回 HTTP 403 model_denylisted,同时你会收到站内通知。24 小时后自动恢复,再次违规会被重新限制。
- 4
30 天内多个模型被暂停
账号暂停全部模型调用,请求返回 HTTP 403 account_restricted,同时你会收到站内通知。不会自动恢复,需要联系客服处理。
多用户平台:按终端用户限制link
如果你用一个账号或一个 API Key 为很多终端用户提供服务,请在每个请求上带 X-End-User-Id 请求头,标明这次请求属于哪个终端用户。某个终端用户反复违规时,Wokey 只限制这个终端用户,你的其他用户照常使用,同时通过站内通知告诉你是哪一个。
curl
curl https://api.wokey.ai/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "X-End-User-Id: u_3f8a2c1e9b7d" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "Hello" }
]
}'- 取值是你自己的终端用户 ID:1–128 个可见 ASCII 字符(字母、数字和符号,不能有空格或中文)。请使用 UUID、内部 ID 或它们的哈希,不要放邮箱、手机号等个人信息。你给 OpenAI safety_identifier 或 Anthropic metadata.user_id 传的值可以直接复用。未登录的用户请传会话 ID,或者不带这个请求头;不要填 anonymous、guest 这类固定值,否则很多人会被当成同一个终端用户一起限制。
- Chat Completions、Responses、Messages 三种文本接口都支持。这个请求头只给 Wokey 使用,不会转发给上游。用 SDK 时,可以在客户端上用 default_headers(Python)或 defaultHeaders(Node.js)统一添加,也可以在单个请求上用 extra_headers 传入。
- 限制规则与上一节相同,但只作用于这个终端用户:同一终端用户在同一模型上短时间内反复触发,先在该模型上限流(同时 1 个请求、每分钟 10 个请求);继续触发,这个模型对该终端用户暂停 24 小时,之后自动恢复;30 天内多个模型被暂停,该终端用户的全部模型调用暂停,需要联系客服恢复。
- 终端用户超出限流或被暂停时,请求返回 HTTP 429 rate_limit_exceeded,不会发往上游,也不收费。终端用户被暂停时,你会收到站内通知,列出终端用户 ID、模型和恢复时间;1 小时内的多条会合并成一条。
- 这个请求头不会放宽账号本身的限制:带不带它,违规都照常计入你的账号,并按上一节处理。被暂停的终端用户的请求不再发往上游,也就不会继续计入账号。触发违规的请求照常收取违规处置费。
- 取值不合规(超长、含空格或非 ASCII 字符、同一请求里重复发送)时,按未带该请求头处理,请求照常完成;同一个 API Key 每天会收到一次站内提醒。
不收费的情况link
- 开启「自用托管」的 API Key,请求只使用你自己托管的凭证。
- 采购订单的 API Key 发起的请求。
- 在 Wokey 入口就被拒绝、没有发到上游的请求,例如 401、402、403、429。
- 普通失败:网络中断、超时、上游过载或限流、参数错误等。
处理建议link
- 收到拒答后不要原样重试。同样的内容大概率会再次被拒,并很快触发限流。先修改请求内容。
- 检查自动化脚本、批处理任务和 Agent,是否在循环发送同一类会被拒绝的请求。
- 如果你在为自己的用户提供服务,建议在请求发给 Wokey 之前做内容过滤,按「模型拒答识别」判断拒答,限制频繁触发的终端用户,并在请求上带 X-End-User-Id,让 Wokey 也能按终端用户单独限制。
- 认为判定有误,或账号调用已被暂停,请联系客服,并附上调用记录里的请求 ID。