Реселлерам/ID и ограничения пользователей

ID конечного пользователя

Если один аккаунт или один 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 или его хеш, но не email, номер телефона и другие персональные данные. Подойдёт то же значение, которое вы передаёте в 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-ключу раз в день приходит напоминание на сайте.