代理轉售/終端使用者識別與限制

終端使用者識別

如果你用一個帳號或一組 API 金鑰為許多終端使用者提供服務，請在每個請求帶上 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 字元（字母、數字與符號；不可有空格或非 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、模型以及恢復時間；一小時內的通知會合併為一則。
此標頭絕不會放寬你帳號的限制：無論是否傳送此標頭，違規都會依帳號層級的限制計入你的帳號。已暫停的終端使用者發出的請求不再送達上游，因此不再計入你的帳號。確實觸發違規的請求，照常收取違規處理費。

違規處置費與風控限制 →

在控制台中管理link

企業與經銷商帳號可以在 API 控制台的「終端使用者」分頁，查看過去 7 天內受限的終端使用者及其拒答原因，並自行解除限流或暫停。每個終端使用者每 24 小時只能用這種方式解除一次；在所有模型上都被暫停的終端使用者仍需由客服處理。如需啟用此分頁，請聯絡客服。

無效值link

無效的值（過長、含有空格或非 ASCII 字元，或同一個請求中傳送了兩次此標頭）會被視為沒有傳送標頭：請求照常完成，每個 API 金鑰每天會收到一次站內提醒。