Ошибки и отказы/Сборы и ограничения за нарушения
Сбор за нарушения и ограничения
Запрос, который апстрим считает нарушением правил использования, создаёт риск блокировки аккаунта модели. За такие запросы Wokey списывает сбор за обработку нарушения, а повторные нарушения ограничивают модель или аккаунт.
На этой страницеexpand_more
Краткоlink
- Сбор взимается только за запросы, которые апстрим явно отклонил по правилам использования, например отказы Claude и отклонения модерацией контента. Обычные ошибки, таймауты, ограничения частоты и неверные параметры не оплачиваются.
- За каждый такой запрос списывается фиксированный сбор за обработку нарушения, базовая сумма — $0.10. Использование модели, которое запрос уже произвёл, оплачивается как обычно.
- Единичное нарушение только оплачивается и не мешает работе. Повторные нарушения на одной модели за короткое время ограничивают или приостанавливают эту модель; если приостановлено несколько моделей, приостанавливаются вызовы моделей для всего аккаунта.
Когда взимается сборlink
| Случай | Какой ответ вы получите | Учитывается в ограничениях |
|---|---|---|
| Отказ модели Claude | HTTP 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
Единичное нарушение
Только сбор за обработку нарушения. Последующие запросы не затрагиваются.
- 2
Повторные нарушения на одной модели за короткое время
Для этой модели временно ограничивается частота: не более 1 одновременного запроса и 10 запросов в минуту на ваш аккаунт, сверх этого возвращается HTTP 429 rate_limit_exceeded. Другие модели не затрагиваются. Ограничение снимается автоматически, когда нарушения прекращаются, обычно в течение 1–2 часов.
- 3
Новые нарушения во время ограничения
Модель приостанавливается на 24 часа: запросы возвращают HTTP 403 model_denylisted, а вы получаете уведомление на сайте. Через 24 часа доступ восстанавливается автоматически; новое нарушение снова ограничит модель.
- 4
Несколько приостановленных моделей за 30 дней
Приостанавливаются вызовы всех моделей аккаунта: запросы возвращают HTTP 403 account_restricted, а вы получаете уведомление на сайте. Автоматически это не снимается — обратитесь в поддержку.
Платформы с конечными пользователями: ограничения по пользователюlink
Если один аккаунт или один API-ключ обслуживает много ваших конечных пользователей, передавайте в каждом запросе заголовок X-End-User-Id, указывающий, к какому конечному пользователю относится запрос. Когда один конечный пользователь нарушает правила снова и снова, Wokey ограничивает только его, остальные ваши пользователи продолжают работать, а уведомление на сайте сообщает, о ком идёт речь.
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 запроса из истории запросов.