Revendedores/ID de usuário final e limites
ID de usuário final
Se uma conta ou uma chave de API atende muitos dos seus próprios usuários finais, envie o cabeçalho X-End-User-Id em todas as requisições para indicar a qual usuário final ela pertence. Quando um usuário final continua violando as políticas, a Wokey restringe apenas esse usuário final, seus demais usuários continuam funcionando e um aviso no app informa qual foi.
Nesta páginaexpand_more
Enviando o cabeçalholink
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" }
]
}'- O valor é o seu próprio ID de usuário final: de 1 a 128 caracteres ASCII visíveis (letras, dígitos e símbolos; sem espaços nem caracteres não ASCII). Use um UUID, um ID interno ou um hash de um deles, nunca um e-mail, número de telefone ou outra informação pessoal. O valor que você já envia como safety_identifier da OpenAI ou metadata.user_id da Anthropic funciona como está. Para usuários não logados, envie um ID de sessão ou omita o cabeçalho; um valor fixo como anonymous ou guest transforma muitas pessoas em um único usuário final, restringido em conjunto.
- Chat Completions, Responses e Messages aceitam o cabeçalho. Ele é só para a Wokey e nunca é repassado ao upstream. Com um SDK, adicione-o para o cliente inteiro com default_headers (Python) ou defaultHeaders (Node.js), ou por requisição com extra_headers.
Restriçõeslink
- As regras são as mesmas das restrições no nível da conta, mas valem apenas para aquele usuário final: violações repetidas de um usuário final em um modelo em pouco tempo primeiro limitam a taxa dele nesse modelo (1 requisição simultânea, 10 requisições por minuto); se as violações continuarem, o modelo é pausado para esse usuário final por 24 horas e depois volta automaticamente; vários modelos pausados em 30 dias pausam todas as chamadas a modelos desse usuário final até o suporte restaurá-las.
- Requisições acima do limite de taxa de um usuário final retornam HTTP 429 rate_limit_exceeded, e requisições de um usuário final pausado retornam HTTP 403 request_blocked. Nenhuma delas chega ao upstream nem é cobrada. Quando um usuário final é pausado, você recebe um aviso no app com o ID de usuário final, o modelo e quando o acesso volta; avisos dentro de uma hora são agrupados em um só.
- O cabeçalho nunca afrouxa os limites da sua conta: as violações contam para a sua conta com ou sem ele, conforme as restrições no nível da conta. Requisições de um usuário final pausado não chegam mais ao upstream, então deixam de contar para a sua conta. Requisições que de fato geram uma violação pagam a taxa de tratamento de violação normalmente.
Gerenciamento no consolelink
Contas empresariais e de revendedor podem ver, na aba Usuários finais do console da API, os usuários finais restringidos e os motivos de recusa dos últimos 7 dias, e remover elas mesmas um limite de taxa ou uma pausa. Cada usuário final pode ser liberado assim uma vez a cada 24 horas; um usuário final pausado em todos os modelos ainda depende do suporte. Fale com o suporte para ativar a aba.
Valores inválidoslink
Um valor inválido (longo demais, com espaços ou caracteres não ASCII, ou o cabeçalho enviado duas vezes na mesma requisição) é tratado como se o cabeçalho não existisse: a requisição é concluída normalmente, e cada chave de API recebe um lembrete no app por dia.