fal.ai content_policy_violation (422): qué lo provoca y cómo solucionarlo
fal.ai devuelve HTTP 422 content_policy_violation cuando se marca un prompt o una imagen. Qué significan las categorías, por qué se bloquean entradas inofensivas, cómo solucionarlo y si se te cobra.
content_policy_violation es el error de fal.ai para una solicitud que un verificador de contenido rechazó. Se devuelve como HTTP 422, no admite reintentos y enviar la misma entrada otra vez fallará de la misma manera. La solución siempre está en la entrada: averigua qué campo fue marcado, lee la categoría y cambia esa parte de la solicitud o usa otro modelo.
Esta guía explica cómo leer el error, las razones habituales por las que se bloquea una entrada inofensiva, cómo corregir cada una y cuánto cuesta una solicitud bloqueada.
Fuentes consultadas el 22 de noviembre de 2026: la referencia de errores y las preguntas frecuentes de fal.
Cómo es el error
La referencia de errores de fal documenta la estructura. El cuerpo es una lista con una entrada por cada problema:
[
{
"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"]
}
]
Los campos que te ayudan:
| Campo | Qué te indica |
|---|---|
type | Siempre content_policy_violation para este error. Compara con este valor, no con el texto del mensaje. |
loc | Qué entrada fue marcada, por ejemplo ["body", "prompt"] o ["body", "image_url"]. En una lista de entradas puede incluir el índice del elemento. |
categories | Opcional. Una o más de harassment, hate, illicit, self-harm, sexual, violence, model_moderated. |
input | El valor que fue marcado. |
model_moderated es la categoría a la que conviene prestar atención. Significa que el rechazo vino de la capa de moderación propia del modelo, no del verificador de fal. Cada modelo tiene su propia capa, así que el mismo prompt puede pasar en un modelo y fallar en otro.
Por qué se bloquean entradas inofensivas
Los verificadores automáticos trabajan con patrones y se inclinan por rechazar ante la duda. Estas son las causas habituales de un falso positivo.
- Palabras ambiguas. Términos de anatomía, medicina y fitness, o palabras como “shoot”, “strip”, “young”, “blood” o “kill” usadas en un sentido inocente.
- Una persona real. Una figura pública reconocible en el prompt o en una imagen de referencia.
- Rostros que llenan el encuadre. Los retratos en primer plano en las imágenes de referencia se rechazan con más frecuencia que los planos de cintura para arriba o más abiertos.
- Menores, o personas que parecen jóvenes, en cualquier contexto, incluidas las fotos familiares.
- Marcas y personajes con derechos de autor. Logotipos, marcas de agua y personajes con nombre.
- Texto dentro de la imagen. El verificador también lee los subtítulos superpuestos y las capturas de pantalla.
- Trajes de baño, ropa interior e imágenes médicas, que los verificadores suelen clasificar como sexuales.
- Efectos de combinación. Dos entradas inofensivas, como un retrato corriente y un prompt corriente, pueden ser rechazadas juntas.
Cómo corregirlo
- Lee primero
locycategories. Te dicen si debes cambiar el prompt o la imagen, y en qué dirección. - Reescribe la frase marcada, no todo el prompt. Sustituye la palabra ambigua por una descripción clara. “Athlete in sportswear stretching” pasa donde una frase más corta y vaga puede no pasar.
- Sustituye o recorta la imagen de referencia. Usa un encuadre más abierto, elimina las marcas de agua y el texto superpuesto, y evita las figuras públicas reconocibles.
- Aísla la causa. Envía el prompt sin la imagen y después la imagen con un prompt neutro. Una de las dos pasará y te mostrará cuál es la entrada problemática.
- Prueba otro modelo cuando la categoría sea
model_moderated. Ese rechazo pertenece al modelo, así que otro modelo para la misma tarea puede aceptar la misma entrada. - No lo repitas en bucle. El error no admite reintentos. Trátalo como un resultado final para esa entrada y muestra al usuario un mensaje claro.
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"
# No admite reintentos: indica al usuario qué entrada cambiar.
return f"blocked:{field}:{categories}"
return "invalid_input" # otros tipos de 422: corrige la entrada, no reintentes
if status in (408, 429) or status >= 500:
return "retry"
return "error"
¿Te cobran una solicitud bloqueada?
La referencia de errores de fal no lo indica. Sus preguntas frecuentes dan la regla general para los errores de cliente: los errores de servidor nunca se cobran, pero una solicitud que falla con un 422 “may still be billed if a runner used GPU time before detecting the error” (puede facturarse si un runner usó tiempo de GPU antes de detectar el error). Un prompt rechazado antes de que empiece la generación no debería costar nada; una salida rechazada después de la generación puede haber usado tiempo de GPU.
Si las solicitudes bloqueadas son frecuentes en tu producto, compara tu registro de solicitudes con la página de facturación para ver cuánto te cuestan. Consulta nuestra guía sobre la facturación de fal.ai para solicitudes fallidas.
Si los bloqueos te cuestan usuarios
Todas las plataformas que alojan estos modelos aplican verificaciones de contenido, y la moderación propia de un modelo se aplica allí donde se aloje. Lo que cambia entre plataformas es con qué frecuencia se bloquean solicitudes corrientes, cuánto cuesta un rechazo y con qué rapidez puedes cambiar a otro modelo.
WaveSpeedAI está diseñado para lograr una alta tasa de éxito en las generaciones:
- Los prompts corrientes pasan. Las verificaciones de contenido apuntan a infracciones claras, de modo que las solicitudes cotidianas con personas, productos y vocabulario común no se rechazan por una palabra ambigua.
- Una tarea bloqueada o fallida no cuesta nada. Si una tarea es detenida por una verificación de contenido o falla por cualquier otro motivo, el 100 % de su coste se devuelve automáticamente a tu saldo.
- Un error claro. Un rechazo se informa con el código de error
1200(Content Moderation), distinto de los errores de parámetros y de los errores de servidor, para que tu código pueda distinguirlos. - Cambia de modelo con una línea. Todos los modelos usan el mismo formato de solicitud y respuesta, así que cuando la moderación propia de un modelo rechaza una entrada, probar con el siguiente modelo es un simple cambio de ruta.
- Las mismas familias de modelos, incluidas Seedance, Kling, Veo, Wan, Nano Banana y Seedream, en el catálogo de modelos.
Puedes probar tus propios prompts en el navegador con el generador de imágenes o el generador de vídeo antes de escribir una sola línea de código. Para migrar una integración, consulta cómo migrar de fal.ai a WaveSpeedAI.
Preguntas frecuentes
¿Qué significa content_policy_violation en fal.ai?
Un verificador de contenido marcó tu prompt, tus archivos multimedia de entrada o la salida generada. fal devuelve HTTP 422 con el tipo content_policy_violation, y la solicitud no admite reintentos.
¿Por qué se marcó mi prompt inofensivo?
Los verificadores automáticos detectan patrones. Las palabras ambiguas, los rostros en primer plano, las personas reales, los logotipos de marcas, el texto dentro de las imágenes y las personas que parecen jóvenes son las causas más comunes de un falso positivo.
¿Qué significa la categoría model_moderated?
La capa de moderación propia del modelo rechazó la solicitud, no el verificador de fal. Otro modelo puede aceptar la misma entrada.
¿Puedo reintentar un content_policy_violation?
No. fal lo marca como no reintentable. Cambia la entrada marcada o usa otro modelo.
¿fal cobra una solicitud bloqueada por el verificador de contenido?
fal no lo indica para este error. Su regla general es que un 422 puede facturarse si se usó tiempo de GPU antes de detectar el error.
¿Existe una API que reembolse las generaciones bloqueadas?
WaveSpeedAI reembolsa íntegramente cada tarea fallida, incluidas las tareas detenidas por una verificación de contenido.
/filters:quality(82)/media/images/1773962750383987480_n3hqzHRZ.webp)