Quickstart

npm install @tuteliq/sdk

pip install tuteliq

// Add to Package.swift dependencies:
.package(url: "https://github.com/Tuteliq/swift.git", from: "1.0.0")

import { Tuteliq } from "@tuteliq/sdk";

const tuteliq = new Tuteliq(process.env.TUTELIQ_API_KEY);

const result = await tuteliq.detectUnsafe({
  content: "Hey, want to meet up after school? Don't tell your parents.",
  context: { ageGroup: "10-12" },
});

console.log(result.severity);    // "high"
console.log(result.categories);  // ["grooming"]
console.log(result.credits_used); // 1

from tuteliq import Tuteliq

client = Tuteliq(api_key=os.environ["TUTELIQ_API_KEY"])

result = client.detect_unsafe(
    text="Hey, want to meet up after school? Don't tell your parents.",
    age_group="10-12",
)

print(result.severity)      # "high"
print(result.categories)    # ["grooming"]
print(result.credits_used)  # 1

curl -X POST https://api.tuteliq.ai/api/v1/safety/unsafe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hey, want to meet up after school? Don'\''t tell your parents.",
    "context": { "age_group": "10-12" }
  }'

const result = await tuteliq.detectSocialEngineering({
  content: "I'm from your school's IT department. I need your password to fix your account urgently.",
  context: { ageGroup: "10-12" },
});

console.log(result.detected);           // true
console.log(result.severity);            // 0.89
console.log(result.categories);          // [{ tag: "AUTH_IMPERSONATION", label: "Authority Impersonation", confidence: 0.92 }]
console.log(result.recommended_action);  // "Block and report to platform administrators"

result = client.detect_social_engineering(
    text="I'm from your school's IT department. I need your password to fix your account urgently.",
    context={"age_group": "10-12"},
)

print(result.detected)            # True
print(result.severity)            # 0.89
print(result.categories)          # [{"tag": "AUTH_IMPERSONATION", "label": "Authority Impersonation", "confidence": 0.92}]
print(result.recommended_action)  # "Block and report to platform administrators"

curl -X POST https://api.tuteliq.ai/api/v1/fraud/social-engineering \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "I'\''m from your school'\''s IT department. I need your password to fix your account urgently.",
    "context": { "ageGroup": "10-12" }
  }'

const result = await tuteliq.analyseMulti({
  content: "Send me your bank details and I'll transfer the money. Don't tell anyone about this.",
  detections: ["social-engineering", "mule-recruitment", "coercive-control"],
  context: { ageGroup: "13-15" },
});

console.log(result.summary.highest_severity);   // "critical"
console.log(result.summary.total_credits_used);  // 3
console.log(result.results.length);              // 3

curl -X POST https://api.tuteliq.ai/api/v1/analyse/multi \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Send me your bank details and I'\''ll transfer the money. Don'\''t tell anyone about this.",
    "endpoints": ["social-engineering", "mule-recruitment", "coercive-control"],
    "context": { "ageGroup": "13-15" }
  }'