Kotlin SDK

dependencies {
    implementation("ai.tuteliq:sdk:1.0.0")
}

dependencies {
    implementation 'ai.tuteliq:sdk:1.0.0'
}

import ai.tuteliq.Tuteliq

val tuteliq = Tuteliq(apiKey = "YOUR_API_KEY")

val tuteliq = Tuteliq(apiKey = BuildConfig.TUTELIQ_API_KEY)

val result = tuteliq.detectUnsafe(
    text = "Let's meet at the park after school, don't tell your parents",
    ageGroup = AgeGroup.TEN_TO_TWELVE
)

println(result.safe)        // false
println(result.severity)    // Severity.HIGH
println(result.categories)  // [Category.GROOMING, Category.SECRECY]

val result = tuteliq.detectGrooming(
    messages = listOf(
        Message(role = Role.STRANGER, text = "Hey, how old are you?"),
        Message(role = Role.CHILD, text = "I'm 11"),
        Message(role = Role.STRANGER, text = "Cool. Do you have your own phone?"),
        Message(role = Role.STRANGER, text = "Let's talk on a different app, just us"),
    ),
    ageGroup = AgeGroup.TEN_TO_TWELVE
)

println(result.groomingDetected) // true
println(result.riskScore)        // 0.92
println(result.stage)            // GroomingStage.ISOLATION

val result = tuteliq.analyzeEmotions(
    text = "Nobody at school talks to me anymore. I just sit alone every day.",
    ageGroup = AgeGroup.THIRTEEN_TO_FIFTEEN
)

println(result.emotions)   // [Emotion(label="sadness", score=0.87), ...]
println(result.distress)   // true
println(result.riskLevel)  // RiskLevel.ELEVATED

val audioFile = File("recording.wav")

val result = tuteliq.analyzeVoice(
    file = audioFile,
    ageGroup = AgeGroup.THIRTEEN_TO_FIFTEEN
)

println(result.transcript)
println(result.safe)
println(result.emotions)

import kotlinx.coroutines.launch

viewModelScope.launch {
    val result = tuteliq.detectUnsafe(
        text = messageText,
        ageGroup = AgeGroup.THIRTEEN_TO_FIFTEEN
    )
    _safetyState.value = result
}

val result = tuteliq.detectSocialEngineering(
    text = "If you really trusted me you'd send me your home address. All my real friends do.",
    ageGroup = AgeGroup.TEN_TO_TWELVE
)

println(result.detected)    // true
println(result.tactics)     // [Tactic.TRUST_EXPLOITATION, Tactic.PEER_PRESSURE]
println(result.riskScore)   // 0.88

val result = tuteliq.detectRomanceScam(
    messages = listOf(
        Message(role = Role.STRANGER, text = "I've never felt this way about anyone before. You're so mature for your age."),
        Message(role = Role.CHILD, text = "Really? That makes me really happy."),
        Message(role = Role.STRANGER, text = "I need you to keep us a secret. People wouldn't understand."),
    ),
    ageGroup = AgeGroup.THIRTEEN_TO_FIFTEEN
)

println(result.detected)    // true
println(result.riskScore)   // 0.91
println(result.indicators)  // [Indicator.LOVE_BOMBING, Indicator.SECRECY_REQUEST, Indicator.AGE_FLATTERY]

val result = tuteliq.detectVulnerabilityExploitation(
    text = "I know you said your parents don't listen to you. I'm different — I actually care. You can tell me anything.",
    ageGroup = AgeGroup.THIRTEEN_TO_FIFTEEN
)

println(result.detected)         // true
println(result.riskScore)        // 0.85
println(result.vulnerabilities)  // [Vulnerability.PARENTAL_CONFLICT, Vulnerability.EMOTIONAL_NEGLECT]

val result = tuteliq.analyseMulti(
    inputs = listOf(
        AnalyseMultiInput(text = "You're so special. Nobody else understands you like I do.", ageGroup = AgeGroup.THIRTEEN_TO_FIFTEEN),
        AnalyseMultiInput(text = "Can you keep a secret from your mum?", ageGroup = AgeGroup.TEN_TO_TWELVE),
    ),
    detections = listOf(Detection.SOCIAL_ENGINEERING, Detection.ROMANCE_SCAM, Detection.GROOMING)
)

println(result.results[0].detections)  // AnalyseMultiDetections(socialEngineering=..., ...)
println(result.results[1].detections)  // AnalyseMultiDetections(grooming=..., ...)

import ai.tuteliq.TuteliqError

try {
    val result = tuteliq.detectUnsafe(
        text = "some content",
        ageGroup = AgeGroup.TEN_TO_TWELVE
    )
} catch (e: TuteliqError) {
    println(e.code)    // e.g. "AUTH_INVALID_KEY"
    println(e.message) // human-readable description
    println(e.status)  // HTTP status code
}

val tuteliq = Tuteliq(
    apiKey = BuildConfig.TUTELIQ_API_KEY,
    baseUrl = "https://api.tuteliq.ai",  // default
    timeout = 30_000L,                    // request timeout in ms
    retries = 2                           // automatic retries on failure
)