Dokumentacja modwall
modwall to API moderacji obrazów i tekstu. Wysyłasz obraz (/v1/moderate) albo tekst (/v1/moderate-text) i dostajesz surowy score. Treść przetwarzamy w pamięci i nigdy nie zapisujemy — logujemy tylko metadane (czas, score, rozmiar). Projektowane tak, żeby działało w produkcji od pierwszego dnia: czytelne kody błędów, webhooki i audit log.
Zakres detekcji (obrazy): nsfw (nagość / treści dla dorosłych) — zawsze; weapon (broń) i violence (przemoc/gore, beta) — włączane per profil klucza, wyniki w polu categories. Obraźliwych gestów nie wykrywamy. Tekst: toksyczność, model multilingual (rozumie polski).
Zakres (obrazy / tekst / obie) wybierasz w planie — endpoint poza Twoim zakresem zwraca 403 capability_required.
Cel: działające zapytanie w 5 minut. Załóż konto → wygeneruj klucz → skopiuj trzy linijki z Szybkiego startu. Nie musisz pisać nawet curl — masz gotowy widget i przykłady kopiuj-wklej w Pythonie, Node.js i PHP.
Dwa sposoby integracji
| API serwerowe | Widget (przeglądarka) | |
|---|---|---|
| Klucz | sk_live_ (sekret, backend) | pk_live_ (publiczny + allowlista domen) |
| Wywołanie | backend ↔ backend | z przeglądarki użytkownika |
| Zastosowanie | kręgosłup compliance, nieobchodzalny | szybki feedback przy uploadzie |
| Dokumentation | API — Referenz | Widget für Ihre Seite |
Zalecenie: widget dla UX, ale realne egzekwowanie zawsze po stronie serwera (API sk_live_). Klucz publiczny + sprawdzanie domeny to ochrona przeglądarkowa, nie kręgosłup compliance.
Od czego zacząć
- Szybki start — klucz i pierwsze zapytanie w 5 minut.
- API — referencja — endpointy, parametry, błędy.
- Polityka i moderacja — progi, kolejka HITL, zgłoszenia, limity.
- Przykłady kodu — curl, Python, Node.js, PHP.
- openapi.json — maszynowa specyfikacja (OpenAPI 3.1).