fal.ai content_policy_violation(422):発生する原因と解決方法
fal.aiは、プロンプトや画像がフラグ付けされると HTTP 422 content_policy_violation を返します。各カテゴリの意味、無害な入力がブロックされる理由、解決方法、そして課金されるかどうかを解説します。
content_policy_violation は、コンテンツチェッカーに拒否されたリクエストに対して fal.ai が返すエラーです。HTTP 422 で返され、再試行はできず、同じ入力を再送しても同じように失敗します。対処は常に入力側で行います。どのフィールドがフラグされたかを特定し、カテゴリを読み取り、リクエストのその部分を変更するか、別のモデルを使用してください。
このガイドでは、エラーの読み方、無害な入力がブロックされる主な理由、それぞれの対処法、そしてブロックされたリクエストにかかる費用について説明します。
情報源の確認日: 2026年11月22日(fal のエラーリファレンスと FAQ)。
エラーの内容
fal のエラーリファレンスに構造が記載されています。ボディは、問題ごとに 1 エントリを持つリストです。
[
{
"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 のうち 1 つ以上。 |
input | フラグされた値。 |
注目すべきは model_moderated です。これは、fal のチェッカーではなく、モデル自身のモデレーション層が拒否したことを意味します。モデルごとにモデレーション層は異なるため、同じプロンプトでも、あるモデルでは通り、別のモデルでは失敗することがあります。
無害な入力がブロックされる理由
自動チェッカーはパターンに基づいて動作し、拒否する側に倒れがちです。誤検知の主な原因は次のとおりです。
- 曖昧な単語。 解剖学・医療・フィットネス関連の用語や、「shoot」「strip」「young」「blood」「kill」など、無害な意味で使われた単語。
- 実在の人物。 プロンプトや参照画像に含まれる、識別可能な著名人。
- フレームいっぱいの顔。 参照画像のクローズアップのポートレートは、腰から上や、より広い構図のものよりも拒否されやすくなります。
- 未成年者、または若く見える人物。 家族写真を含め、あらゆる文脈が対象です。
- ブランドと著作権のあるキャラクター。 ロゴ、透かし、名前のあるキャラクター。
- 画像内のテキスト。 重ねて表示されたキャプションやスクリーンショットも、チェッカーに読み取られます。
- 水着、下着、医療画像。 チェッカーが性的なものとして分類することがよくあります。
- 組み合わせによる影響。 通常のポートレートと通常のプロンプトのように、それぞれ無害な 2 つの入力が、組み合わさることで拒否される場合があります。
対処方法
- まず
locとcategoriesを読む。 プロンプトと画像のどちらを、どの方向に変更すべきかが分かります。 - プロンプト全体ではなく、フラグされたフレーズを書き換える。 曖昧な単語を平易な描写に置き換えます。短く曖昧なフレーズでは通らなくても、「Athlete in sportswear stretching」なら通ることがあります。
- 参照画像を差し替えるかクロップする。 より広い構図にし、透かしや重ねたテキストを取り除き、識別可能な著名人は避けます。
- 原因を切り分ける。 画像なしでプロンプトだけを送り、次に中立的なプロンプトで画像だけを送ります。どちらか一方は通り、どの入力が問題かが分かります。
- カテゴリが
model_moderatedの場合は別のモデルを試す。 この拒否はモデル自身によるものなので、同じタスクの別のモデルなら同じ入力を受け付ける可能性があります。 - ループしない。 このエラーは再試行できません。その入力に対する最終結果として扱い、ユーザーに分かりやすいメッセージを表示してください。
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"
# Not retryable: tell the user which input to change.
return f"blocked:{field}:{categories}"
return "invalid_input" # other 422 types: fix the input, do not retry
if status in (408, 429) or status >= 500:
return "retry"
return "error"
ブロックされたリクエストは課金されるのか
fal のエラーリファレンスには記載がありません。FAQ には、クライアントエラーに関する一般的なルールが示されています。サーバーエラーは課金されませんが、422 で失敗したリクエストは「エラーを検出する前にランナーが GPU 時間を使用した場合、課金されることがある」とされています。生成が始まる前に拒否されたプロンプトは無料のはずですが、生成後に拒否された出力は GPU 時間を消費している可能性があります。
ブロックされたリクエストが自社プロダクトで頻繁に発生する場合は、リクエストログと請求ページを照合して、どれだけのコストになっているかを確認してください。fal.ai の失敗したリクエストの請求に関するガイドもご覧ください。
ブロックによってユーザーを失っているなら
これらのモデルをホストするプラットフォームはどこでもコンテンツチェックを実施しており、モデル自身のモデレーションは、そのモデルがどこでホストされていても適用されます。プラットフォーム間で異なるのは、通常のリクエストがどれくらいの頻度で引っかかるか、拒否された場合にいくらかかるか、そして別のモデルにどれだけ素早く切り替えられるかです。
WaveSpeedAI は、高い生成成功率を実現するように作られています。
- 通常のプロンプトは通ります。 コンテンツチェックは明確な違反を対象としているため、人物、商品、一般的な表現を含む日常的なリクエストが、曖昧な単語 1 つで拒否されることはありません。
- ブロックされた、または失敗したタスクは無料です。 タスクがコンテンツチェックで停止された場合、またはその他の理由で失敗した場合、その費用の 100% が自動的に残高へ返金されます。
- 明確な 1 つのエラー。 拒否はエラーコード
1200(Content Moderation)として報告され、パラメータエラーやサーバーエラーとは区別されるため、コード側で見分けられます。 - 1 行でモデルを切り替え。 すべてのモデルが同じリクエスト・レスポンス形式を使うため、あるモデル自身のモデレーションが入力を拒否した場合も、次のモデルを試すにはパスを変更するだけです。
- 同じモデルファミリー。 Seedance、Kling、Veo、Wan、Nano Banana、Seedream などをモデルカタログで利用できます。
コードを書く前に、画像ジェネレーターや動画ジェネレーターを使って、ブラウザ上で自分のプロンプトをテストできます。既存の連携を移行するには、fal.ai から WaveSpeedAI への移行方法をご覧ください。
FAQ
fal.ai の content_policy_violation とは何ですか?
コンテンツチェッカーが、プロンプト、入力メディア、または生成された出力をフラグしました。fal は type が content_policy_violation の HTTP 422 を返し、このリクエストは再試行できません。
無害なプロンプトがフラグされたのはなぜですか?
自動チェッカーはパターンに基づいて判定します。曖昧な単語、顔のクローズアップ、実在の人物、ブランドロゴ、画像内のテキスト、若く見える人物が、誤検知の最も一般的な原因です。
カテゴリ model_moderated とは何ですか?
fal のチェッカーではなく、モデル自身のモデレーション層がリクエストを拒否したことを意味します。別のモデルなら同じ入力を受け付ける可能性があります。
content_policy_violation は再試行できますか?
できません。fal は再試行不可としています。フラグされた入力を変更するか、別のモデルを使用してください。
fal はコンテンツチェッカーにブロックされたリクエストに課金しますか?
このエラーについて fal は明示していません。一般的なルールとして、エラーが検出される前に GPU 時間が使われた場合、422 は課金されることがあります。
ブロックされた生成を返金する API はありますか?
WaveSpeedAI は、コンテンツチェックで停止されたタスクを含め、失敗したすべてのタスクを全額返金します。
/filters:quality(82)/media/images/1773962750383987480_n3hqzHRZ.webp)