WaveSpeedAI

fal.ai content_policy_violation (422): что его вызывает и как исправить

fal.ai возвращает HTTP 422 content_policy_violation, когда промпт или изображение помечены фильтром. Что означают категории, почему блокируются безобидные входные данные, как это исправить и списываются ли с вас деньги.

By WaveSpeedAI6 min read

content_policy_violation — это ошибка fal.ai для запроса, который отклонила система проверки контента. Она приходит как HTTP 422 и не подлежит повторной отправке: тот же запрос завершится так же. Исправлять всегда нужно входные данные: определите, какое поле было помечено, прочитайте категорию и измените эту часть запроса либо используйте другую модель.

В этом руководстве объясняется, как читать ошибку, почему блокируются безобидные входные данные, как исправить каждую из частых причин и сколько стоит заблокированный запрос.

Источники проверены 22 ноября 2026 года: справочник ошибок fal и FAQ.

Как выглядит ошибка

Структура описана в справочнике ошибок fal. Тело ответа — список, в котором по одной записи на каждую проблему:

[
  {
    "loc": ["body", "prompt"],
    "msg": "The content was flagged by a content checker.",
    "type": "content_policy_violation",
    "url": "https://docs.fal.ai/errors#content_policy_violation",
    "input": "the flagged input",
    "categories": ["sexual"]
  }
]

Поля, которые помогают разобраться:

ПолеО чём оно говорит
typeДля этой ошибки всегда content_policy_violation. Ориентируйтесь на него, а не на текст сообщения.
locКакой именно вход был помечен, например ["body", "prompt"] или ["body", "image_url"]. Для списка входных данных может содержать индекс элемента.
categoriesНеобязательное поле. Одно или несколько значений: harassment, hate, illicit, self-harm, sexual, violence, model_moderated.
inputЗначение, которое было помечено.

Обратите внимание на model_moderated. Оно означает, что отказ пришёл от собственного уровня модерации модели, а не от проверки fal. У разных моделей уровни разные, поэтому один и тот же промпт может пройти на одной модели и не пройти на другой.

Почему блокируются безобидные входные данные

Автоматические проверки работают по шаблонам и предпочитают перестраховаться. Вот обычные причины ложных срабатываний.

  • Неоднозначные слова. Анатомические, медицинские и фитнес-термины, а также слова вроде «shoot», «strip», «young», «blood» или «kill» в безобидном значении.
  • Реальный человек. Узнаваемая публичная персона в промпте или на референсном изображении.
  • Лица, занимающие весь кадр. Портреты крупным планом в референсных изображениях отклоняются чаще, чем кадры по пояс или более общие планы.
  • Несовершеннолетние или люди, выглядящие молодо, в любом контексте, включая семейные фотографии.
  • Бренды и персонажи, защищённые авторским правом. Логотипы, водяные знаки и именованные персонажи.
  • Текст на изображении. Наложенные подписи и скриншоты проверка тоже считывает.
  • Купальники, нижнее бельё и медицинские изображения, которые проверки часто относят к сексуальному контенту.
  • Совокупный эффект. Два безобидных входа, например обычный портрет и обычный промпт, могут быть отклонены вместе.

Как это исправить

  1. Сначала прочитайте loc и categories. Они подскажут, что менять — промпт или изображение, и в какую сторону.
  2. Перепишите помеченную фразу, а не весь промпт. Замените неоднозначное слово простым описанием. «Athlete in sportswear stretching» проходит там, где более короткая и расплывчатая фраза может не пройти.
  3. Замените референсное изображение или обрежьте его. Используйте более общий план, уберите водяные знаки и наложенный текст, избегайте узнаваемых публичных персон.
  4. Определите причину изоляцией. Отправьте промпт без изображения, затем изображение с нейтральным промптом. Один из вариантов пройдёт и покажет, какой вход вызывает проблему.
  5. Попробуйте другую модель, если категория — model_moderated. Такой отказ принадлежит самой модели, поэтому другая модель для той же задачи может принять тот же вход.
  6. Не зацикливайтесь. Ошибка не подлежит повтору. Считайте её окончательным результатом для этого входа и покажите пользователю понятное сообщение.
def handle_fal_error(status: int, body) -> str:
    if status == 422 and isinstance(body, list):
        for item in body:
            if item.get("type") == "content_policy_violation":
                field = ".".join(str(part) for part in item.get("loc", []))
                categories = ", ".join(item.get("categories", [])) or "unspecified"
                # Повтор невозможен: сообщите пользователю, какой вход нужно изменить.
                return f"blocked:{field}:{categories}"
        return "invalid_input"          # другие типы 422: исправьте вход, не повторяйте
    if status in (408, 429) or status >= 500:
        return "retry"
    return "error"

Списываются ли деньги за заблокированный запрос?

В справочнике ошибок fal об этом не сказано. В FAQ приведено общее правило для клиентских ошибок: серверные ошибки не тарифицируются, но запрос, завершившийся ошибкой 422, «может быть оплачен, если раннер использовал время GPU до обнаружения ошибки». Промпт, отклонённый до начала генерации, должен стоить нулевую сумму; результат, отклонённый после генерации, мог потребовать времени GPU.

Если заблокированные запросы в вашем продукте — частое явление, сравните журнал запросов со страницей биллинга, чтобы увидеть, во сколько они вам обходятся. См. наше руководство по тарификации неудачных запросов fal.ai.

Если блокировки стоят вам пользователей

Любая платформа, на которой размещены эти модели, проводит проверки контента, а собственная модерация модели действует везде, где эта модель размещена. Платформы различаются тем, как часто под проверку попадают обычные запросы, сколько стоит отказ и как быстро можно переключиться на другую модель.

WaveSpeedAI создан для высокой доли успешных генераций:

  • Обычные промпты проходят. Проверки контента нацелены на явные нарушения, поэтому повседневные запросы с людьми, товарами и привычными формулировками не отклоняются из-за неоднозначного слова.
  • Заблокированная или неудавшаяся задача ничего не стоит. Если задача остановлена проверкой контента или завершилась ошибкой по любой другой причине, 100% её стоимости автоматически возвращается на ваш баланс.
  • Одна понятная ошибка. Отказ возвращается с кодом ошибки 1200 (Content Moderation), отдельно от ошибок параметров и серверных ошибок, так что ваш код может их различать.
  • Переключение моделей одной строкой. У всех моделей одинаковый формат запроса и ответа, поэтому когда собственная модерация одной модели отклоняет вход, переход к следующей модели сводится к смене пути.
  • Те же семейства моделей, включая Seedance, Kling, Veo, Wan, Nano Banana и Seedream, в каталоге моделей.

Прежде чем писать код, вы можете проверить свои промпты в браузере с помощью генератора изображений или генератора видео. Чтобы перенести интеграцию, см. как перейти с fal.ai на WaveSpeedAI.

FAQ

Что означает content_policy_violation в fal.ai?

Система проверки контента пометила ваш промпт, входные медиафайлы или сгенерированный результат. fal возвращает HTTP 422 с типом content_policy_violation, и запрос не подлежит повтору.

Почему мой безобидный промпт был помечен?

Автоматические проверки сопоставляют шаблоны. Неоднозначные слова, лица крупным планом, реальные люди, логотипы брендов, текст на изображениях и люди, выглядящие молодо, — самые частые причины ложного срабатывания.

Что означает категория model_moderated?

Запрос отклонил собственный уровень модерации модели, а не проверка fal. Другая модель может принять тот же вход.

Можно ли повторить запрос после content_policy_violation?

Нет. fal помечает эту ошибку как не подлежащую повтору. Измените помеченный вход или используйте другую модель.

Списывает ли fal деньги за запрос, заблокированный проверкой контента?

Для этой ошибки fal этого не указывает. Общее правило таково: запрос с ошибкой 422 может быть оплачен, если до обнаружения ошибки использовалось время GPU.

Есть ли API, которое возвращает деньги за заблокированные генерации?

WaveSpeedAI полностью возвращает стоимость каждой неудавшейся задачи, включая задачи, остановленные проверкой контента.

Поделиться