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
Header
| Header | Wert |
|---|---|
| X-API-KeyPflicht | Dein Schlüssel, siehe Authentifizierung. |
| Content-Type | application/json |
Body
| Feld | Typ | Beschreibung |
|---|---|---|
| textPflicht | string | Die Nachricht. Nach dem Entfernen von Leerzeichen am Rand 1 bis 2.000 Zeichen. |
| level | string | light, medium oder strict. Standard: medium. Siehe Stufen. |
| model | string | axo-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
{
"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
| Status | Bedeutung |
|---|---|
| 200 | Geprüft. Antwort im Antwortformat. |
| 401 | Schlüssel fehlt, ist falsch oder widerrufen. |
| 403 | Modell nicht im Tarif oder Early Preview nicht freigegeben. |
| 422 | Text leer oder länger als 2.000 Zeichen, level ungültig, unbekanntes Modell oder JSON fehlerhaft. |
| 429 | Sekundenlimit erreicht oder Guthaben des Monats aufgebraucht. |
| 503 | Das 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.