代理转售/终端用户标识与限制

终端用户标识

如果你用一个账号或一个 API Key 为很多终端用户提供服务，请在每个请求上带 X-End-User-Id 请求头，标明这次请求属于哪个终端用户。某个终端用户反复违规时，Wokey 只限制这个终端用户，你的其他用户照常使用，同时通过站内通知告诉你是哪一个。

本页内容expand_more

请求头写法link

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 传入。

限制规则link

  • 限制规则与账号级风控限制相同，但只作用于这个终端用户：同一终端用户在同一模型上短时间内反复触发，先在该模型上限流（同时 1 个请求、每分钟 10 个请求）；继续触发，这个模型对该终端用户暂停 24 小时，之后自动恢复；30 天内多个模型被暂停，该终端用户的全部模型调用暂停，需要联系客服恢复。
  • 终端用户超出限流时，请求返回 HTTP 429 rate_limit_exceeded；终端用户被暂停时，返回 HTTP 403 request_blocked。两种情况都不会发往上游，也不收费。终端用户被暂停时，你会收到站内通知，列出终端用户 ID、模型和恢复时间；1 小时内的多条会合并成一条。
  • 这个请求头不会放宽账号本身的限制：带不带它，违规都照常计入你的账号，并按账号级风控限制处理。被暂停的终端用户的请求不再发往上游，也就不会继续计入账号。触发违规的请求照常收取违规处置费。

违规处置费与风控限制 →

控制台管理link

企业和中转账号可以在 API 控制台的「终端用户」页签查看受限的终端用户和近 7 天的拒答原因，并自助解除限流和暂停。同一终端用户 24 小时内只能自助解除一次；全部模型都被暂停的终端用户仍需联系客服。需要开通这个页签请联系客服。

取值不合规时link

取值不合规（超长、含空格或非 ASCII 字符、同一请求里重复发送）时，按未带该请求头处理，请求照常完成；同一个 API Key 每天会收到一次站内提醒。