Ошибки и отказы/Сборы и ограничения за нарушения

Сбор за нарушения и ограничения

Запрос, который апстрим считает нарушением правил использования, создаёт риск блокировки аккаунта модели. За такие запросы Wokey списывает сбор за обработку нарушения, а повторные нарушения ограничивают модель или аккаунт.

На этой страницеexpand_more

Краткоlink

  • Сбор взимается только за запросы, которые апстрим явно отклонил по правилам использования, например отказы Claude и отклонения модерацией контента. Обычные ошибки, таймауты, ограничения частоты и неверные параметры не оплачиваются.
  • За каждый такой запрос списывается фиксированный сбор за обработку нарушения, базовая сумма — $0.10. Использование модели, которое запрос уже произвёл, оплачивается как обычно.
  • Единичное нарушение только оплачивается и не мешает работе. Повторные нарушения на одной модели за короткое время ограничивают или приостанавливают эту модель; если приостановлено несколько моделей, приостанавливаются вызовы моделей для всего аккаунта.

Когда взимается сборlink

СлучайКакой ответ вы получитеУчитывается в ограничениях
Отказ модели ClaudeHTTP 200, stop_reason "refusal" (в Chat Completions — finish_reason "content_filter")Да
Отклонение модерацией контента апстрима (Volcengine Ark, xAI и др.)HTTP 4xx с кодом ошибки, например InputTextSensitiveContentDetected или SensitiveContentDetectedДа
Блокировка по политике кибербезопасности OpenAIКод ошибки cyber_policyНет, только сбор
Ответ Claude заблокирован фильтром контентаHTTP 400, Output blocked by content filtering policyНет, только сбор

Как рассчитывается сборlink

  • Базовая сумма — $0.10 за запрос. Как и использование модели, она учитывает ценовую корректировку вашего аккаунта (наценку или скидку); точная сумма видна в истории запросов.
  • Если до отклонения запрос уже израсходовал входные или выходные токены, они оплачиваются по обычной цене, а сбор за обработку нарушения списывается дополнительно.
  • Для аккаунтов с 30 и более нарушениями на моделях GPT за последние 30 дней сбор удваивается (база $0.20) на всех моделях. Список обновляется ежедневно, и обычный сбор возвращается, когда число нарушений снижается.
  • В разделе «История запросов» консоли такие запросы отмечены как неудачные. Наведите курсор на значок ошибки, чтобы увидеть списанный сбор, а разверните сумму, чтобы увидеть детализацию.

Ограничения при повторных нарушенияхlink

  1. 1

    Единичное нарушение

    Только сбор за обработку нарушения. Последующие запросы не затрагиваются.

  2. 2

    Повторные нарушения на одной модели за короткое время

    Для этой модели временно ограничивается частота: не более 1 одновременного запроса и 10 запросов в минуту на ваш аккаунт, сверх этого возвращается HTTP 429 rate_limit_exceeded. Другие модели не затрагиваются. Ограничение снимается автоматически, когда нарушения прекращаются, обычно в течение 1–2 часов.

  3. 3

    Новые нарушения во время ограничения

    Модель приостанавливается на 24 часа: запросы возвращают HTTP 403 model_denylisted, а вы получаете уведомление на сайте. Через 24 часа доступ восстанавливается автоматически; новое нарушение снова ограничит модель.

  4. 4

    Несколько приостановленных моделей за 30 дней

    Приостанавливаются вызовы всех моделей аккаунта: запросы возвращают HTTP 403 account_restricted, а вы получаете уведомление на сайте. Автоматически это не снимается — обратитесь в поддержку.

За серьёзные нарушения или намеренный обход мер контроля рисков платформа может сразу заблокировать аккаунт согласно Политике допустимого использования.

Платформы с конечными пользователями: ограничения по пользователюlink

Если один аккаунт или один API-ключ обслуживает много ваших конечных пользователей, передавайте в каждом запросе заголовок X-End-User-Id, указывающий, к какому конечному пользователю относится запрос. Когда один конечный пользователь нарушает правила снова и снова, Wokey ограничивает только его, остальные ваши пользователи продолжают работать, а уведомление на сайте сообщает, о ком идёт речь.

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.
  • Правила те же, что в предыдущем разделе, но действуют только на этого конечного пользователя: при повторных нарушениях на одной модели за короткое время для него сначала ограничивается частота на этой модели (1 одновременный запрос, 10 запросов в минуту); при продолжении модель для него приостанавливается на 24 часа и затем восстанавливается автоматически; если за 30 дней приостановлено несколько моделей, все вызовы моделей для этого конечного пользователя приостанавливаются до восстановления службой поддержки.
  • Запросы сверх ограничения частоты или от приостановленного конечного пользователя возвращают HTTP 429 rate_limit_exceeded, не отправляются в апстрим и не оплачиваются. Когда конечный пользователь приостановлен, вы получаете уведомление на сайте с его ID, моделью и временем восстановления; уведомления в течение часа объединяются в одно.
  • Заголовок не ослабляет ограничения вашего аккаунта: нарушения засчитываются аккаунту с ним и без него, как описано в предыдущем разделе. Запросы приостановленного конечного пользователя больше не попадают в апстрим и поэтому перестают засчитываться аккаунту. За запросы, вызвавшие нарушение, сбор за обработку нарушения списывается как обычно.
  • Недопустимое значение (слишком длинное, с пробелами или не-ASCII символами, заголовок передан дважды) обрабатывается так, будто заголовка нет: запрос выполняется как обычно, а по каждому API-ключу раз в день приходит напоминание на сайте.

Когда сбор не взимаетсяlink

  • API-ключи с включённым режимом «Свои учётные данные»: запросы используют только ваши собственные учётные данные.
  • Запросы по API-ключу заказа на закупку.
  • Запросы, отклонённые на шлюзе Wokey до отправки в апстрим, например 401, 402, 403 и 429.
  • Обычные сбои: обрыв соединения, таймауты, перегрузка или ограничения апстрима, неверные параметры и т. п.

Что делатьlink

  • Не отправляйте отклонённый запрос повторно без изменений. Тот же контент, скорее всего, снова будет отклонён и быстро приведёт к ограничению. Сначала измените запрос.
  • Проверьте, не повторяют ли скрипты автоматизации, пакетные задания или агенты в цикле один и тот же тип отклоняемых запросов.
  • Если вы обслуживаете своих пользователей, фильтруйте контент до отправки в Wokey, распознавайте отказы, как описано в разделе «Как распознать отказ модели», ограничивайте конечных пользователей, которые часто их вызывают, и передавайте X-End-User-Id, чтобы Wokey тоже мог ограничивать их по отдельности.
  • Если вы считаете решение ошибочным или вызовы моделей на аккаунте приостановлены, обратитесь в поддержку и укажите ID запроса из истории запросов.