Send a message, a post or a comment. Detectivision raises self_harm when the text encourages, describes or talks about suicide or self-harm, with how sure it is, in Turkish and English. What happens next is yours: a check-in, a helpline, a person.
One flag, self_harm, for three kinds of text:
Texts that urge someone to hurt themselves.
Texts that describe self-harm or suicide.
Texts that talk about it, which can be someone asking for help.
curl https://api.detectivision.ai/api/v1/moderation \
-H "Api-Key: $DETECTIVISION_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "text_moderation",
"input": "I do not see the point of anything anymore. I just want it all to stop.",
"mode": "detect",
"flags": ["self_harm"],
"metadata": { "userId": "u_123" }
}'{
"id": 5208,
"type": "text_moderation",
"mode": "detect",
"status": "completed",
"flagged": true,
"flags": [{ "flag": "self_harm", "confidence": 0.78 }],
"checked": ["self_harm"],
"unchecked": [],
"tookMs": 590,
"usage": { "charged": 2, "remaining": 9998 },
"metadata": { "userId": "u_123" }
}metadata comes back unchanged in the answer, in Logs and in every webhook, so the person who wrote it can be reached.
A raised self_harm is often someone who needs help. Send it to a trained person rather than deleting it in silence.
Put your user id in metadata. It comes back with the answer and in every webhook about the request.
Define actions such as Reach out or Escalate. When someone takes one, your system gets a moderation.action webhook.
Posts, comments and direct messages.
Chat between players.
Messages between matches.
No. It says that a text talks about self-harm, with a confidence from 0 to 1. Treat it as a reason for a person to look, never as a verdict about someone.
Turkish and English. Text in other languages is checked, but the results are not reliable.
Yes. Send "flags": ["self_harm"]. Only that flag is checked, and the answer comes faster. Checking fewer flags never costs more.
Yes. With "async": true the API answers at once with the request’s id, and the result comes as a moderation.completed webhook, at half the price of an answer given at once.