fal.ai content_policy_violation (422): Was ihn auslöst und wie man ihn behebt
fal.ai gibt HTTP 422 content_policy_violation zurück, wenn ein Prompt oder ein Bild markiert wird. Was die Kategorien bedeuten, warum harmlose Eingaben blockiert werden, wie Sie das Problem beheben und ob Ihnen etwas berechnet wird.
content_policy_violation ist der Fehler von fal.ai für eine Anfrage, die ein Inhaltsprüfer abgelehnt hat. Er kommt als HTTP 422 zurück, ist nicht wiederholbar, und dieselbe Eingabe noch einmal zu senden, scheitert auf dieselbe Weise. Die Lösung liegt immer auf der Eingabeseite: Finden Sie heraus, welches Feld markiert wurde, lesen Sie die Kategorie und ändern Sie diesen Teil der Anfrage oder verwenden Sie ein anderes Modell.
Dieser Leitfaden erklärt, wie Sie den Fehler lesen, aus welchen häufigen Gründen eine harmlose Eingabe blockiert wird, wie Sie jeden dieser Fälle beheben und was eine blockierte Anfrage kostet.
Quellen geprüft am 22. November 2026: fals Fehlerreferenz und FAQ.
Wie der Fehler aussieht
fals Fehlerreferenz dokumentiert die Struktur. Der Body ist eine Liste mit einem Eintrag pro Problem:
[
{
"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"]
}
]
Die Felder, die Ihnen weiterhelfen:
| Feld | Was es Ihnen sagt |
|---|---|
type | Bei diesem Fehler immer content_policy_violation. Prüfen Sie darauf, nicht auf den Meldungstext. |
loc | Welche Eingabe markiert wurde, zum Beispiel ["body", "prompt"] oder ["body", "image_url"]. Bei einer Liste von Eingaben kann der Index des Elements enthalten sein. |
categories | Optional. Eine oder mehrere von harassment, hate, illicit, self-harm, sexual, violence, model_moderated. |
input | Der Wert, der markiert wurde. |
Auf model_moderated sollten Sie besonders achten. Es bedeutet, dass die Ablehnung von der eigenen Moderationsschicht des Modells kam, nicht von fals Prüfer. Verschiedene Modelle haben verschiedene Schichten, daher kann derselbe Prompt bei einem Modell durchgehen und bei einem anderen scheitern.
Warum harmlose Eingaben blockiert werden
Automatische Prüfer arbeiten mit Mustern und lehnen im Zweifel eher ab. Das sind die üblichen Ursachen für einen Fehlalarm.
- Mehrdeutige Wörter. Anatomie-, Medizin- und Fitnessbegriffe sowie Wörter wie „shoot“, „strip“, „young“, „blood“ oder „kill“, die in einem harmlosen Sinn verwendet werden.
- Eine reale Person. Eine erkennbare Person des öffentlichen Lebens im Prompt oder in einem Referenzbild.
- Gesichter, die das Bild ausfüllen. Nahaufnahmen von Porträts in Referenzbildern werden häufiger abgelehnt als Halbkörper- oder weitere Aufnahmen.
- Minderjährige oder Personen, die jung wirken, in jedem Kontext, auch bei Familienfotos.
- Marken und urheberrechtlich geschützte Figuren. Logos, Wasserzeichen und benannte Figuren.
- Text im Bild. Eingeblendete Untertitel und Screenshots liest der Prüfer ebenfalls aus.
- Bademode, Unterwäsche und medizinische Bilder, die Prüfer oft als sexuell einstufen.
- Kombinationseffekte. Zwei harmlose Eingaben, etwa ein gewöhnliches Porträt und ein gewöhnlicher Prompt, können zusammen abgelehnt werden.
So beheben Sie den Fehler
- Lesen Sie zuerst
locundcategories. Sie zeigen Ihnen, ob Sie den Prompt oder das Bild ändern sollten und in welche Richtung. - Formulieren Sie die markierte Wendung um, nicht den ganzen Prompt. Ersetzen Sie das mehrdeutige Wort durch eine schlichte Beschreibung. „Athlete in sportswear stretching“ geht durch, wo eine kürzere, vagere Formulierung vielleicht scheitert.
- Ersetzen oder beschneiden Sie das Referenzbild. Wählen Sie einen weiteren Bildausschnitt, entfernen Sie Wasserzeichen und eingeblendeten Text und vermeiden Sie erkennbare Personen des öffentlichen Lebens.
- Grenzen Sie die Ursache ein. Senden Sie den Prompt ohne das Bild, dann das Bild mit einem neutralen Prompt. Eines von beiden geht durch und zeigt Ihnen, welche Eingabe das Problem ist.
- Probieren Sie ein anderes Modell, wenn die Kategorie
model_moderatedlautet. Diese Ablehnung gehört zum Modell, daher kann ein anderes Modell für dieselbe Aufgabe dieselbe Eingabe akzeptieren. - Wiederholen Sie die Anfrage nicht in einer Schleife. Der Fehler ist nicht wiederholbar. Behandeln Sie ihn als endgültiges Ergebnis für diese Eingabe und zeigen Sie dem Nutzer eine klare Meldung.
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"
# Nicht wiederholbar: dem Nutzer sagen, welche Eingabe zu ändern ist.
return f"blocked:{field}:{categories}"
return "invalid_input" # andere 422-Typen: Eingabe korrigieren, nicht wiederholen
if status in (408, 429) or status >= 500:
return "retry"
return "error"
Wird eine blockierte Anfrage berechnet?
fals Fehlerreferenz sagt dazu nichts. Die FAQ nennt die allgemeine Regel für Client-Fehler: Serverfehler werden nie berechnet, aber eine Anfrage, die mit einem 422 fehlschlägt, „may still be billed if a runner used GPU time before detecting the error“ (kann trotzdem berechnet werden, wenn ein Runner GPU-Zeit verbraucht hat, bevor er den Fehler erkannt hat). Ein Prompt, der vor Beginn der Generierung abgelehnt wird, sollte nichts kosten; eine Ausgabe, die nach der Generierung abgelehnt wird, kann GPU-Zeit verbraucht haben.
Wenn blockierte Anfragen in Ihrem Produkt häufig vorkommen, vergleichen Sie Ihr Anfrageprotokoll mit der Abrechnungsseite, um zu sehen, was sie Sie kosten. Lesen Sie dazu unseren Leitfaden zur Abrechnung fehlgeschlagener Anfragen bei fal.ai.
Wenn Blockierungen Sie Nutzer kosten
Jede Plattform, die diese Modelle hostet, führt Inhaltsprüfungen durch, und die eigene Moderation eines Modells gilt überall dort, wo das Modell gehostet wird. Die Plattformen unterscheiden sich darin, wie oft gewöhnliche Anfragen erwischt werden, was eine Ablehnung kostet und wie schnell Sie auf ein anderes Modell wechseln können.
WaveSpeedAI ist auf eine hohe Erfolgsquote bei der Generierung ausgelegt:
- Gewöhnliche Prompts gehen durch. Die Inhaltsprüfungen zielen auf eindeutige Verstöße, daher werden alltägliche Anfragen mit Personen, Produkten und gängigen Formulierungen nicht wegen eines mehrdeutigen Wortes abgewiesen.
- Eine blockierte oder fehlgeschlagene Aufgabe kostet nichts. Wird eine Aufgabe von einer Inhaltsprüfung gestoppt oder schlägt aus einem anderen Grund fehl, werden 100 % ihrer Kosten automatisch Ihrem Guthaben gutgeschrieben.
- Ein eindeutiger Fehler. Eine Ablehnung wird mit dem Fehlercode
1200(Content Moderation) gemeldet, getrennt von Parameterfehlern und Serverfehlern, sodass Ihr Code sie unterscheiden kann. - Modellwechsel mit einer Zeile. Alle Modelle verwenden dasselbe Anfrage- und Antwortformat. Lehnt die eigene Moderation eines Modells eine Eingabe ab, genügt für den Versuch mit dem nächsten Modell eine Änderung des Pfads.
- Dieselben Modellfamilien, darunter Seedance, Kling, Veo, Wan, Nano Banana und Seedream, im Modellkatalog.
Sie können Ihre eigenen Prompts im Browser mit dem Bildgenerator oder dem Videogenerator testen, bevor Sie Code schreiben. Wie Sie eine Integration umziehen, lesen Sie unter So migrieren Sie von fal.ai zu WaveSpeedAI.
FAQ
Was bedeutet content_policy_violation bei fal.ai?
Ein Inhaltsprüfer hat Ihren Prompt, Ihre Eingabemedien oder die generierte Ausgabe markiert. fal liefert HTTP 422 mit dem Typ content_policy_violation, und die Anfrage ist nicht wiederholbar.
Warum wurde mein harmloser Prompt markiert?
Automatische Prüfer gleichen Muster ab. Mehrdeutige Wörter, Gesichts-Nahaufnahmen, reale Personen, Markenlogos, Text in Bildern und Personen, die jung wirken, sind die häufigsten Ursachen für einen Fehlalarm.
Was bedeutet die Kategorie model_moderated?
Die eigene Moderationsschicht des Modells hat die Anfrage abgelehnt, nicht fals Prüfer. Ein anderes Modell kann dieselbe Eingabe akzeptieren.
Kann ich einen content_policy_violation wiederholen?
Nein. fal kennzeichnet ihn als nicht wiederholbar. Ändern Sie die markierte Eingabe oder verwenden Sie ein anderes Modell.
Berechnet fal eine vom Inhaltsprüfer blockierte Anfrage?
fal äußert sich dazu für diesen Fehler nicht. Die allgemeine Regel lautet, dass ein 422 berechnet werden kann, wenn vor der Erkennung des Fehlers GPU-Zeit verbraucht wurde.
Gibt es eine API, die blockierte Generierungen erstattet?
WaveSpeedAI erstattet jede fehlgeschlagene Aufgabe vollständig, einschließlich Aufgaben, die von einer Inhaltsprüfung gestoppt wurden.
/filters:quality(82)/media/images/1773962750383987480_n3hqzHRZ.webp)