Einstieg

Schnellstart

Vom Konto bis zur ersten geprüften Zeile in vier Schritten.

1. Zugang anfragen

   Registriere dich. Wir geben dein Konto frei, danach startest du im Free-Tarif mit monatlichem Guthaben.

2. Im Playground testen

   Im Playground prüfst du Zeilen ohne Schlüssel und ohne Kosten. So bekommst du ein Gefühl für Scores und Stufen.

3. Schlüssel anlegen

   Unter Schlüssel erzeugst du einen API-Schlüssel. Er wird nur einmal angezeigt. Leg ihn als Umgebungsvariable AXO_KEY auf deinem Server ab.

4. Erste Anfrage senden

   Schick eine Zeile an /v1/check:

curl -X POST https://api.axolite.app/v1/check \
  -H "X-API-Key: $AXO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "du bist so ein idiot", "level": "medium"}'

Antwort auswerten

{
  "toxic": true,
  "score": 0.71,
  "severity": 2,
  "action": "flag",
  "rule": null,
  "categories": {},
  "model": "axo-small",
  "lang": "de",
  "self_harm": false
}

action ist die Empfehlung für deine Stufe. Ein typischer Umgang damit:

switch (result.action) {
  case "block":
    await deleteMessage(message);
    break;
  case "flag":
    await sendToModerators(message, result.score);
    break;
  default:
    // allow: nichts tun
}

Wie es weitergeht

• Wähle die passende Stufe für deine Community.
• Lege eigene Regeln für Begriffe an, die bei euch anders gemeint sind.
• Fang Fehler wie 429 sauber ab.
• Für viele Zeilen auf einmal gibt es /v1/checks im Pro-Tarif.
• axo-medium und axo-medium-preview-2 sind Previews im Pro-Tarif. Preview heißt, der Stand kann zurückgerollt werden; bei preview-2 können Fehlalarme höher liegen. Die Stufe bleibt einstellbar. axo-large ist ein Early Preview nach Freigabe durch einen Superadmin. Details unter Modelle.