API-Referenz

Eine Zeile prüfen

Bewertet eine einzelne Chat-Nachricht und empfiehlt eine Aktion für die gewählte Stufe.

POSThttps://api.axolite.app/v1/check
HeaderWert
X-API-KeyPflichtDein Schlüssel, siehe Authentifizierung.
Content-Typeapplication/json

Body

FeldTypBeschreibung
textPflichtstringDie Nachricht. Nach dem Entfernen von Leerzeichen am Rand 1 bis 2.000 Zeichen.
levelstringlight, medium oder strict. Standard: medium. Siehe Stufen.
modelstringaxo-small (Standard), axo-medium (Preview, nur Pro), axo-medium-preview-2 (neuer Medium-Stand, Preview, nur Pro) oder axo-large (Early Preview nach Freigabe). Siehe Modelle.

Beispiel

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

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

Alle Felder erklärt das Antwortformat.

Statuscodes

StatusBedeutung
200Geprüft. Antwort im Antwortformat.
401Schlüssel fehlt, ist falsch oder widerrufen.
403Modell nicht im Tarif oder Early Preview nicht freigegeben.
422Text leer oder länger als 2.000 Zeichen, level ungültig, unbekanntes Modell oder JSON fehlerhaft.
429Sekundenlimit erreicht oder Guthaben des Monats aufgebraucht.
503Das Modell startet gerade. Kurz warten und erneut senden.

Der genaue Text steht im Feld detail, siehe Fehler.

Kosten

Eine erfolgreiche Prüfung mit axo-small kostet kostenlos pro 1.000 Zeilen, mit axo-medium oder axo-medium-preview-2 0,05 €. axo-large hat noch keinen Listenpreis und zählt im Early Preview wie axo-small. Abgelehnte Anfragen kosten nichts. Mehr unter Guthaben und Limits.