Jak naprawić błąd API 400: treść wiadomości zablokowana (OpenAI / Claude API)

Co oznacza ten błąd

Gdy wywołujesz /v1/chat/completions (lub Messages API dla Claude), dostawca skanuje wiadomości użytkownika, historię asystenta, a czasem prompty systemowe przed uruchomieniem wnioskowania. Jeśli klasyfikator uzna treść za niedozwoloną, API zwraca 400 Bad Request z ładunkiem podobnym do:

{
  "error": {
    "message": "messages: text content blocked",
    "type": "invalid_request_error",
    "code": "content_filter"
  }
}

Dokładne sformułowanie może się różnić (text content blocked, content_policy_violation, moderation_blocked), ale wzorzec jest ten sam: żądanie nigdy nie zostało zrealizowane normalnie – zostałeś zatrzymany na warstwie bezpieczeństwa.

Różni się to od błędów ograniczenia szybkości (429) lub błędów nieprawidłowego klucza API. Blokady treści występują nawet przy aktywnym koncie i wystarczającym limicie.

Typowe przyczyny

1. Jawne lub dorozumiane naruszenia polityki – treści seksualne, drastyczna przemoc, instrukcje samookaleczenia, mowa nienawiści lub prompty typu jailbreak, które modele moderacji traktują jako wysokiego ryzyka.
2. Długa historia wielo-obrotowa – wcześniejsza tura użytkownika lub asystenta w tym samym wątku może zawierać zablokowany tekst; API ocenia pełną tablicę messages, a nie tylko ostatnią linię.
3. Przesłany lub osadzony tekst – wklejone dokumenty, wyniki OCR lub wyniki narzędzi wstrzyknięte do konwersacji mogą wyzwolić filtry niezwiązane z Twoim zamiarem.
4. Zachowanie przekaźnika innej firmy – niektórzy resellerzy przekazują żądania bez zmian; jeśli ich dostawca nadrzędny jest bardziej rygorystyczny niż oczekiwano, w Twoim kliencie lub logach zobaczysz surowy ciąg błędu dostawcy (api error 400 messages text content blocked).
5. Zasady specyficzne dla modelu – API do generowania obrazów i niektóre modele w wersji preview stosują oddzielne potoki moderacji (np. GPT Image, DALL·E) z ostrzejszymi zasadami wizualnymi/treściowymi niż czat tekstowy.

Jak to naprawić

1. Wyizoluj zablikowaną turę

Wyślij minimalne żądanie jednosilne zawierające tylko Twój najnowszy tekst użytkownika. Jeśli się powiedzie, przeszukaj historię czatu metodą binarną – usuwaj starsze tury, aż wywołanie zadziała. Większość blokad pochodzi z jednej historycznej wiadomości, a nie z całej sesji.

2. Przeformułuj bez obchodzenia zasad

Przepisz żądanie tak, aby było zgodne z polityką: skup się na intencji, usuń niedozwolone szczegóły, użyj neutralnego sformułowania. Nie stosuj oczywistych jailbreaków typu „ignoruj poprzednie zasady” – często zwiększają one wskaźnik blokad.

3. Przytnij prompty systemowe i wyniki narzędzi

Sprawdź role system oraz wiadomości funkcji/narzędzi. Ukryte instrukcje lub zeskrobana treść sieciowa często wyzwalają filtry, których programiści się nie spodziewali.

4. Wypróbuj inny model lub dostawcę

Niektóre modele stosują łagodniejszą moderację tekstu w przypadku zadań związanych z kodowaniem lub analizą. Jeśli używasz bramy lub agregatora, przełączenie model na alternatywny nadrzędny może zadziałać dla tego samego logicznego zadania – z zastrzeżeniem warunków każdego dostawcy.

5. Użyj bramy z routingiem i zabezpieczeniami

Aplikacje produkcyjne nie powinny polegać na jednej ścieżce nadrzędnej. Brama LLM może:

• Kierować do dostawców o zgodnym zachowaniu polityki dla Twojego przypadku użycia
• Ponawiać próby na alternatywnych kanałach, gdy jeden dostawca nadrzędny zwróci błędy moderacji
• Rejestrować, która tura się nie powiodła, abyś mógł programowo oczyścić wejście

APIMaster udostępnia punkty końcowe kompatybilne z OpenAI z agregacją wielokanałową. W przypadku granicznego ruchu produkcyjnego oznacza to mniej twardych błędów 400 zatrzymujących aplikację – oraz dostęp pay-as-you-go od doładowania od $1 bez zarządzania wieloma kontami u różnych dostawców.

Rozpocznij z APIMaster →

Jak APIMaster pomaga

Masz dość twardych blokad moderacji? APIMaster rozwiązuje ten problem na trzech frontach:

Zaleta	Co otrzymujesz
Zniżka	Ceny z marketplace – do ~90% / ~85% taniej niż stawki listowe OpenAI / Claude (ceny na żywo).
Stabilność	Routing wielokanałowy – gdy jeden dostawca nadrzędny zwróci 400 z powodu moderacji, przełącz na inny kanał lub model zamiast blokady pojedynczego dostawcy.
Wierność modelu	Wykrywanie odcisku palca potwierdza, że trasy zapasowe nadal dostarczają model, za który zapłaciłeś.

Kompatybilne z OpenAI: https://apimaster.ai/v1. Od doładowania od $1, pay-as-you-go.

Zarejestruj się na APIMaster →

Powiązane błędy API

• Nieprawidłowy klucz API (OpenAI / Claude) – błędy uwierzytelniania → Tester kluczy API
• Przekroczono limit szybkości OpenAI – dławienie 429
• Claude / Anthropic 529 przeciążenie – błędy wydajności
• ChatGPT nieobsługiwana lokalizacja – zablokowany region
• Wszystkie przewodniki naprawy błędów API – pełny indeks

FAQ

Co oznacza „api error 400 messages text content blocked”? Oznacza, że system bezpieczeństwa dostawcy API zablokował tekst w ładunku messages przed wygenerowaniem odpowiedzi. Napraw, edytując lub usuwając oznaczoną treść, albo kierując przez bramę z alternatywnymi dostawcami nadrzędnymi.

Czy to to samo co OpenAI content_filter? Tak – ta sama klasa błędu. Sformułowanie różni się w zależności od SDK, proxy i dostawcy, ale HTTP 400 + zablokowany tekst/filtr treści wskazuje na moderację, a nie na nieprawidłowy klucz.

Czy mogę wyłączyć moderację treści w OpenAI lub Claude? Oficjalne poziomy konsumenckie i standardowe API nie pozwalają na wyłączenie podstawowych filtrów bezpieczeństwa. Umowy korporacyjne mogą się różnić. Bramy innych firm różnią się; zawsze przestrzegaj warunków dostawcy i obowiązującego prawa.

Czy APIMaster obchodzi moderację treści? APIMaster kieruje przez wiele kanałów, aby poprawić dostępność i ceny. Nadal jesteś odpowiedzialny za zgodne z prawem i polityką użytkowanie. Platforma ma na celu zmniejszenie pojedynczych punktów awarii (w tym rygorystycznej moderacji nadrzędnej na jednej trasie), a nie obejście systemów bezpieczeństwa dostawcy.