內容安全
什麼都沒改,請求卻突然全部失敗?多半是內容安全規則暫時暫停了你的呼叫。這篇文件講清楚三件事:什麼會觸發它、暫停多久、接下來該做什麼。
內容安全審核是什麼
你透過 OfoxAI 送出的每個請求,最後都會抵達上游供應商(OpenAI、Anthropic、Google 等)營運的模型。這些供應商會依各自的使用政策檢查收到的文字、圖片與檔案,不符合的直接拒絕。OfoxAI 在這之上多加了一層:當一個帳號持續送出被拒絕的請求,平台會暫停這個帳號的呼叫一段時間,而不是繼續把請求轉送上去。
這個暫停保護兩件事:你的帳號在上游供應商那裡的信用,以及所有 OfoxAI 使用者共用的呼叫通道。
它和速率限制不是同一回事
| 速率限制 | 內容安全暫停 | |
|---|---|---|
| 觸發原因 | 請求送得太快 | 請求裡裝的是什麼內容 |
| 你看到的現象 | 429 Too Many Requests | 請求被判定違反政策而拒絕 |
| 怎麼解決 | 放慢速度再重試 | 找出被判定的內容並改掉 |
| 持續多久 | 幾秒 | 5 分鐘到 12 小時 |
正常業務為什麼也會被判定
被拒絕的內容分兩類:一類確實違反了供應商的使用政策或 OfoxAI 服務條款 ,另一類是自動分類器判錯了。讓人意外的基本上都屬於第二類。
最常見的幾種狀況:
- 對被拒絕的請求反覆重試。腳本收到一次拒絕,把同一段內容又重試了四次,一次判定就變成五次。這是最快撞上下面第一檔門檻的方式。
- 批次處理不是自己寫的內容。爬回來的網頁、使用者評論、客服紀錄、PDF 裡,夾著沒人逐條看過的內容。
- 直接把終端使用者的輸入原樣送出。只要產品把訪客輸入原封不動送給模型,遲早會有人輸入被判定的內容。
- 很長的多輪對話。每一輪都會把完整歷史重新送給模型,一則被判定的訊息只要不刪,就會一直重複計數。
- 誤判。人像照片、醫療問題、資安研究、小說情節都可能被讀錯。而且不同供應商的標準並不一致,同一份素材在 A 模型被拒,在 B 模型可能正常通過。
單次請求被拒絕不是處罰,把這一條改掉就好。只有短時間內被拒絕的次數累積起來,才會觸發暫停。
階梯規則
兩件事決定後果:短時間內累積了多少次判定,以及這個帳號之前被暫停過幾次。
觸發暫停的門檻
判定次數以滑動視窗統計,達到其中任一條就會觸發暫停:
| 統計視窗 | 觸發次數 |
|---|---|
| 1 分鐘 | 5 次 |
| 5 分鐘 | 15 次 |
| 30 分鐘 | 30 次 |
每次暫停多久
再次觸發會逐級加長:
| 第幾次暫停 | 暫停時長 |
|---|---|
| 第 1 次 | 5 分鐘 |
| 第 2 次 | 15 分鐘 |
| 第 3 次 | 1 小時 |
| 第 4 次 | 4 小時 |
| 第 5 次 | 12 小時 |
一個典型過程:批次任務 1 分鐘內被判定 5 次,暫停 5 分鐘;資料沒整理就重跑,又被判定 5 次,這次暫停 15 分鐘。要打斷這個循環,關鍵是在第一次暫停期間就把資料處理掉。
暫停期間,相關請求會在 OfoxAI 這一端直接被拒絕,不會送到模型,也不會產生費用。時間一到自動恢復,不需要聯絡任何人,也不需要額外操作。
累犯計數不會跟你一輩子:一段時間不再觸發,下次就會從第 1 級重新開始。如果在最長一級之後仍然反覆觸發,帳號會轉入人工審核,依據服務條款 可能被限制或中止服務。
另外註冊帳號、或是新建一支 API Key 來規避暫停,屬於違反服務條款,不是解決辦法。真的等不了,請直接聯絡客服。
該怎麼處理
已經被暫停了
- 先停下來。暫停任務,關掉自動重試。重試不會讓暫停提早結束。
- 找出被判定的請求。開啟控制台 的 日誌(Logs) 頁面,依第一次失敗前後的時間篩選,找出被拒絕的那些請求。
- 改掉來源。刪掉或改寫這些內容,並確認重試邏輯、任務佇列不會把同樣的輸入再送一次。
- 等時間到。時間到會自動恢復。
- 小批量重啟。先送幾筆確認沒問題,再放開整批任務。
怎麼避免再次觸發
- 一則內容被拒絕,就當它對這個輸入是最終答案:記錄下來、跳過去,不要迴圈重試。
- 面向大眾的產品,使用者輸入送給模型之前先做一道過濾。
- 匯入或爬取的資料,大批量執行之前先人工抽驗。
- 長對話裡把被判定的那幾輪刪掉,而不是把完整歷史一直重送。
- 不同業務用不同的 API Key,出問題時在日誌裡一眼就能看出是哪個任務。
如果覺得是誤判
分類器確實會判錯。寄信到 support@ofoxai.com,寫清楚:
- 帳號信箱
- 請求被擋下的時間(註明時區)
- 呼叫的模型
- 日誌頁面裡的一兩個請求 ID
不要在信裡附上 API Key、密碼,也不要貼超出排查需要的客戶資料。我們會核對觸發原因,並在可說明的範圍內把結果告訴你。
你可能收到的信
帳號被限制時,OfoxAI 可能會寄一封通知到註冊信箱。真正的通知來自 OfoxAI 的信箱位址(@ofoxai.com 或 @ofox.ai),會寫明是哪個帳號、限制了什麼、持續多久、該去查什麼。
收到之後:
- 自己開啟控制台登入,不要直接點信裡的連結,再依信裡的時間去查 日誌 頁面。
- 先把內容改掉再重啟任務。信件只是告訴你發生了什麼,不會替你把限制解除。
- 認為判錯了,直接回覆這封信,或是寫信到 support@ofoxai.com。
OfoxAI 絕不會向你索取:
- API Key、密碼或驗證碼
- 任何形式的「恢復服務費用」
- 把溝通轉到私人信箱或聊天軟體
只要對方索取以上任何一項,不管寄件人寫的是誰,都是釣魚信。轉寄到 support@ofoxai.com,然後刪掉它。