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 的錯誤參考文件記載了其結構。回應內容是一個列表,每個問題對應一個項目:
[
{
"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」等以無害意義使用的詞。
- 真實人物。 提示詞或參考圖片中出現可辨識的公眾人物。
- 臉部佔滿畫面。 參考圖片中的特寫肖像,比半身或更廣的構圖更常被拒絕。
- 未成年人,或看起來年輕的人, 在任何情境下皆然,包括家庭照片。
- 品牌與受著作權保護的角色。 標誌、浮水印與有名稱的角色。
- 圖片內的文字。 疊加的字幕與螢幕截圖同樣會被檢查器讀取。
- 泳裝、內衣與醫療影像, 檢查器常將其歸類為性相關內容。
- 組合效應。 兩個各自無害的輸入,例如一張普通肖像與一段普通提示詞,可能會一起被拒絕。
如何修正
- 先讀取
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 為高生成成功率而打造:
- 一般提示詞可順利通過。 內容檢查針對明確的違規,因此涉及人物、產品與常見用語的日常請求,不會因為一個語意模糊的詞而被拒絕。
- 被封鎖或失敗的任務不收費。 若任務被內容檢查攔下,或因其他任何原因失敗,其費用會 100% 自動退回你的餘額。
- 單一清楚的錯誤。 拒絕會以錯誤碼
1200(Content Moderation)回報,與參數錯誤和伺服器錯誤分開,讓你的程式碼能區分它們。 - 一行即可切換模型。 每個模型都使用相同的請求與回應格式,因此當某個模型自身的審核拒絕了輸入時,改試下一個模型只需更改路徑。
- 相同的模型系列, 包括 Seedance、Kling、Veo、Wan、Nano Banana 與 Seedream,皆收錄於模型目錄。
在撰寫任何程式碼之前,你可以先在瀏覽器中使用圖片生成器或影片生成器測試自己的提示詞。若要遷移整合,請參閱如何從 fal.ai 遷移到 WaveSpeedAI。
常見問題
fal.ai 上的 content_policy_violation 是什麼意思?
內容檢查器標記了你的提示詞、輸入媒體或生成的輸出。fal 會回傳 HTTP 422,類型為 content_policy_violation,且該請求不可重試。
為什麼我的無害提示詞被標記?
自動化檢查器依據模式比對。語意模糊的詞彙、特寫臉部、真實人物、品牌標誌、圖片中的文字,以及看起來年輕的人,是誤判最常見的原因。
類別 model_moderated 是什麼意思?
是模型自身的審核層拒絕了請求,而非 fal 的檢查器。其他模型可能會接受相同的輸入。
我可以重試 content_policy_violation 嗎?
不行。fal 將其標示為不可重試。請修改被標記的輸入,或改用不同的模型。
fal 會對被內容檢查器封鎖的請求收費嗎?
fal 並未針對此錯誤說明。其一般規則是,若在偵測到錯誤前已使用 GPU 時間,422 可能會被計費。
有沒有會退還被封鎖生成的 API?
WaveSpeedAI 會全額退還每一個失敗的任務,包括被內容檢查攔下的任務。
/filters:quality(82)/media/images/1773962750383987480_n3hqzHRZ.webp)