Revendedores/ID de usuario final y límites
ID de usuario final
Si una cuenta o una clave de API atiende a muchos de tus propios usuarios finales, envía el encabezado X-End-User-Id en cada solicitud para indicar a qué usuario final pertenece. Cuando un usuario final sigue infringiendo las políticas, Wokey restringe solo a ese usuario final, tus demás usuarios siguen funcionando y un aviso en la app te dice de quién se trata.
En esta páginaexpand_more
Enviar el encabezadolink
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" }
]
}'- El valor es tu propio ID de usuario final: de 1 a 128 caracteres ASCII visibles (letras, dígitos y símbolos; sin espacios ni caracteres no ASCII). Usa un UUID, un ID interno o un hash de alguno de ellos, nunca un correo electrónico, un número de teléfono u otra información personal. El valor que ya envías como safety_identifier de OpenAI o metadata.user_id de Anthropic sirve tal cual. Para usuarios sin sesión iniciada, envía un ID de sesión u omite el encabezado; un valor fijo como anonymous o guest convierte a muchas personas en un solo usuario final, restringido en conjunto.
- Chat Completions, Responses y Messages lo aceptan. El encabezado es solo para Wokey y nunca se reenvía al upstream. Con un SDK, agrégalo para todo el cliente con default_headers (Python) o defaultHeaders (Node.js), o por solicitud con extra_headers.
Restriccioneslink
- Las reglas coinciden con las restricciones a nivel de cuenta, pero se aplican solo a ese usuario final: las infracciones repetidas de un usuario final en un modelo en poco tiempo primero limitan su tasa en ese modelo (1 solicitud simultánea, 10 solicitudes por minuto); si las infracciones continúan, ese modelo se pausa para ese usuario final durante 24 horas y después vuelve automáticamente; varios modelos pausados en 30 días pausan todas las llamadas a modelos de ese usuario final hasta que soporte las restablezca.
- Las solicitudes que superan el límite de tasa de un usuario final devuelven HTTP 429 rate_limit_exceeded, y las de un usuario final pausado devuelven HTTP 403 request_blocked. Ninguna llega al upstream ni se cobra. Cuando se pausa a un usuario final recibes un aviso en la app con el ID de usuario final, el modelo y cuándo vuelve el acceso; los avisos de una misma hora se combinan en uno.
- El encabezado nunca relaja los límites de tu cuenta: las infracciones cuentan para tu cuenta con o sin él, según las restricciones a nivel de cuenta. Las solicitudes de un usuario final pausado ya no llegan al upstream, así que dejan de contar para tu cuenta. Las solicitudes que sí provocan una infracción pagan la tarifa por gestión de infracciones como de costumbre.
Gestión en la consolalink
Las cuentas empresariales y de revendedor pueden revisar en la pestaña Usuarios finales de la consola de API a los usuarios finales restringidos y sus motivos de rechazo de los últimos 7 días, y levantar ellas mismas un límite de tasa o una pausa. Cada usuario final puede liberarse así una vez cada 24 horas; un usuario final pausado en todos los modelos sigue necesitando a soporte. Contacta a soporte para activar la pestaña.
Valores no válidoslink
Un valor no válido (demasiado largo, con espacios o caracteres no ASCII, o el encabezado enviado dos veces en una solicitud) se trata como si no hubiera encabezado: la solicitud se completa con normalidad y cada clave de API recibe un recordatorio en la app por día.