Schnellstart
Od zera do działającego zapytania w trzech krokach.
1. Załóż konto i odbierz klucz
Zarejestruj się, wejdź do panelu → Klucze API → Nowy klucz. Pełny klucz sk_live_… pokazujemy raz — skopiuj go od razu.
2. Wyślij obraz
curl -X POST https://modwall.dev/v1/moderate \ -H "Authorization: Bearer sk_live_..." \ -F "image=@zdjecie.jpg"
import requests
r = requests.post(
"https://modwall.dev/v1/moderate",
headers={"Authorization": "Bearer sk_live_..."},
files={"image": open("zdjecie.jpg", "rb")},
)
print(r.json())
import fs from "node:fs";
const fd = new FormData();
fd.append("image", new Blob([fs.readFileSync("zdjecie.jpg")]), "zdjecie.jpg");
const r = await fetch("https://modwall.dev/v1/moderate", {
method: "POST",
headers: { Authorization: "Bearer sk_live_..." },
body: fd,
});
console.log(await r.json());
3. Odczytaj odpowiedź
{
"scores": { "nsfw": 0.97, "safe": 0.03 },
"decision": "allow",
"recommended_action": "block",
"mode": "monitor",
"threshold": 0.8,
"model_version": "falconsai-int8-1"
}
scores to surowe prawdopodobieństwa (zawsze zwracane). recommended_action to rekomendacja modelu, a decision to akcja dla Ciebie wg trybu konta.
Nowe konto startuje w trybie monitor — modwall niczego nie blokuje (decision zawsze allow), tylko pokazuje, co by oflagował. To celowe: wpinasz się bez ryzyka dla platformy i w panelu widzisz, ile i jak celnie modwall łapie na Twoim ruchu. Gdy zaufasz liczbom, w panelu przełącz tryb na review (kolejka HITL) lub enforce (auto-blok). Szczegóły: Polityka i moderacja.
Dalej
- Pełna referencja API (parametry, błędy, zgłoszenia, kolejka).
- Widget — jeśli wolisz wkleić kod na stronę zamiast wołać API z backendu.
- Przykłady w Pythonie / Node / PHP.