Documentation Index
Fetch the complete documentation index at: https://docs.tuteliq.ai/llms.txt
Use this file to discover all available pages before exploring further.
Every Tuteliq API call consumes credits. Credit costs vary by endpoint based on processing complexity. Your current balance and usage are always available through the dashboard and the API.
Per-endpoint costs
Core Safety
| Endpoint | Credits | Notes |
|---|
detectBullying | 5 | Single text analysis |
detectUnsafe | 5 | Single text analysis |
detectGrooming | 6 per 10 msgs | ceil(messages / 10) × 6, minimum 6 |
Fraud Detection
| Endpoint | Credits | Notes |
|---|
detectSocialEngineering | 5 | Social engineering tactic detection |
detectAppFraud | 5 | Fraudulent app/download detection |
detectRomanceScam | 5 | Romance scam pattern detection |
detectMuleRecruitment | 5 | Money mule recruitment detection |
Safety Extended
| Endpoint | Credits | Notes |
|---|
detectGamblingHarm | 5 | Gambling harm detection |
detectCoerciveControl | 5 | Coercive control detection |
detectVulnerabilityExploitation | 5 | Vulnerability exploitation + cross-endpoint modifier |
detectRadicalisation | 5 | Radicalisation indicator detection |
Multi-Endpoint Analysis
| Endpoint | Credits | Notes |
|---|
analyseMulti | Sum of endpoints | Fan-out to up to 10 endpoints in one call |
Analysis & Guidance
| Endpoint | Credits | Notes |
|---|
analyzeEmotions | 6 per 10 msgs | ceil(messages / 10) × 6, minimum 6 |
getActionPlan | 9 | Longer generation |
generateReport | 13 | Structured output |
Synthetic Content Detection
| Endpoint | Credits | Notes |
|---|
detectSyntheticContent | 5 | Multi-signal forensic analysis (text, image, audio, video) |
Verification
| Endpoint | Credits | Notes |
|---|
verifyAge (liveness only) | 10 | Liveness detection + biometric estimation |
verifyAge (full) | 20 | Document analysis + liveness + biometric estimation (Pro tier and above) |
verifyIdentity | 25 | Document verification + liveness + face matching (Business tier and above) |
Document Analysis
| Endpoint | Credits | Notes |
|---|
analyzeDocument | Dynamic | max(10, pages_analyzed × endpoint_count) — minimum 10 credits |
| Endpoint | Credits | Notes |
|---|
analyzeVoice | 21+ | Base 21 (first 60s) + 15 per extra minute |
analyzeImage | 7 | Vision + OCR + analysis |
analyzeVideo | 95 | Frame extraction + per-frame vision |
| Voice stream (per flush) | 7 | Real-time transcription + analysis |
| Video stream (per frame) | 7 | Per-frame vision analysis |
For conversation-based endpoints (detectGrooming, analyzeEmotions), credits scale with message count. A 25-message conversation costs ceil(25 / 10) × 6 = 18 credits.For analyzeVoice, credits scale with audio duration. The base cost of 21 credits covers the first 60 seconds. Each additional minute adds 15 credits. Examples: 2 min = 36 credits, 5 min = 81 credits, 10 min = 156 credits.
Batch processing example
When submitting a batch of 500 text messages through detectUnsafe:
500 messages x 5 credits = 2,500 credits
detectGrooming with 15 messages per conversation:
200 conversations x ceil(15 / 10) x 6 = 200 x 12 = 2,400 credits
Purchasing credits
Credits can be purchased from the Tuteliq Dashboard. Navigate to Billing > Purchase Credits to top up your balance. Plans include monthly credit allowances, with overage billing available for high-volume usage.
Tracking usage
Response body
Every API response includes a credits_used field showing the credits consumed by that request:
{
"detected": true,
"severity": 0.85,
"confidence": 0.91,
"risk_score": 0.87,
"categories": [{ "tag": "AUTH_IMPERSONATION", "label": "Authority Impersonation", "confidence": 0.92 }],
"credits_used": 5
}
X-Credits-Remaining header with your current balance:
X-Credits-Remaining: 9472
Usage endpoints
Check your credit balance and historical usage programmatically via the Usage API:
const usage = await tuteliq.getUsage();
console.log(usage.credits_remaining);
console.log(usage.credits_used_today);
Low-balance alerts
Configure low-balance notifications in the Dashboard under Settings > Alerts. You can set a credit threshold (e.g., 100 credits remaining) and receive email or webhook notifications before you run out.
What happens when credits run out
When your balance reaches zero, API requests return a 402 Payment Required error. Upgrade your plan or purchase additional credits from the Dashboard to resume service. 
