리셀러/최종 사용자 ID 및 제한
최종 사용자 ID
하나의 계정이나 하나의 API 키로 여러 최종 사용자에게 서비스를 제공한다면, 모든 요청에 X-End-User-Id 헤더를 보내 요청이 어느 최종 사용자의 것인지 표시하세요. 한 최종 사용자가 위반을 반복하면 Wokey는 해당 최종 사용자만 제한하고 다른 사용자는 계속 이용할 수 있으며, 앱 내 알림으로 어느 사용자인지 알려 드립니다.
헤더 보내기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로, 표시 가능한 ASCII 문자 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 키마다 하루에 한 번 앱 내 알림을 보냅니다.