๐Ÿ›ก๏ธ Veritas AI API

Advanced Multi-Model Spam Detection & Content Analysis

API v2.2

๐Ÿš€ Getting Started

Welcome to the Veritas AI! Our cutting-edge artificial intelligence platform provides comprehensive spam detection and content analysis using multiple specialized models. Get started in minutes with our simple REST API.

Why Choose Audentio?

  • Specialized Fine-Tuned AI Models - Each optimized for different content types and use cases
  • 99.9%+ Accuracy - Industry-leading spam detection performance
  • Multi-language Support - Support for 20+ languages including Chinese, Arabic, Spanish
  • Real-time Processing - Lightning-fast responses for instant protection
  • Content Safety - Advanced moderation across 9 safety categories
  • Easy Integration - Simple REST API with comprehensive documentation

๐Ÿ”ฅ Quick Example

curl
curl -X POST https://spam.audent.ai/check \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-api-key" \
  -d '{
    "text": "Congratulations! You've won a $1,000 gift card!"
  }'
Response 200 OK
{
  "processing_time": 482,
  "results": {
    "bert": { "result": "Not Spam", "processing_time": 2 },
    "otis": { "result": { "prediction": "Spam", "probability": 0.9999 }, "processing_time": 4 },
    "roberta": { "result": "Spam", "processing_time": 393 },
    "sentiment": { "result": { "label": "Very Negative", "score": 0.55 }, "processing_time": 21 }
  }
}

๐Ÿ” Authentication

Secure your API access with our flexible authentication system. All requests require an API key passed in the request headers.

๐Ÿ“ API Key Header

Include your API key in every request using the X-API-KEY header:

HTTP Header
X-API-KEY: your-api-key-here

๐Ÿ†“ Demo Access

For testing and evaluation, use the demo API key:

X-API-KEY: demo

Note: Demo accounts have rate limits of 1 request per 5 seconds. Upgrade to a paid plan for higher limits and production use.

๐Ÿ”’ Security Best Practices

๐Ÿ“ก API Endpoints

Our REST API provides both individual model endpoints for specific use cases and a comprehensive analysis endpoint that runs all models simultaneously.

POST https://spam.audent.ai/check
Run comprehensive analysis using all available AI models. Perfect for getting complete insights into content quality and safety.
curl
curl -X POST https://spam.audent.ai/check \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-api-key" \
  -d '{
    "text": "Congratulations! You've won a $1,000 gift card!"
  }'

Request Body

JSON
{
  "text": "Your text content to analyze"
}

Example Response

200 OK - Success 200
{
                            "is_spam": true,
                            "processing_time": 643,
                            "results": {
                                "bert": {
                                    "is_spam": false,
                                    "processing_time": 6,
                                    "result": "Not Spam"
                                },
                                "bertsms": {
                                    "is_spam": false,
                                    "processing_time": 0,
                                    "result": {
                                        "probability": 0.9273504614830017,
                                        "type": "Not Spam"
                                    }
                                },
                                "detoxify": {
                                    "processing_time": 45,
                                    "result": {
                                        "details": [
                                            {
                                                "label": "toxicity",
                                                "probability": 0.0008303595241159201
                                            },
                                            {
                                                "label": "severe_toxicity",
                                                "probability": 0.00011060516408178955
                                            },
                                            {
                                                "label": "obscene",
                                                "probability": 0.00016450308612547815
                                            },
                                            {
                                                "label": "threat",
                                                "probability": 0.0001268200867343694
                                            },
                                            {
                                                "label": "insult",
                                                "probability": 0.0001895991590572521
                                            },
                                            {
                                                "label": "identity_attack",
                                                "probability": 0.0001446763053536415
                                            }
                                        ],
                                        "prediction": {
                                            "label": "ok",
                                            "probability": 0.0008303595241159201
                                        }
                                    }
                                },
                                "koala": {
                                    "processing_time": 77,
                                    "result": {
                                        "details": [
                                            {
                                                "category": "OK",
                                                "definition": "Not offensive.",
                                                "label": "OK",
                                                "probability": 0.993174135684967
                                            },
                                            {
                                                "category": "hate",
                                                "definition": "Content that expresses, incites, or promotes hate based on race, gender, ethnicity, religion, nationality, sexual orientation, disability status, or caste.",
                                                "label": "H",
                                                "probability": 0.0018990079406648874
                                            },
                                            {
                                                "category": "self-harm",
                                                "definition": "Content that promotes, encourages, or depicts acts of self-harm, such as suicide, cutting, and eating disorders.",
                                                "label": "SH",
                                                "probability": 0.0015057099517434835
                                            },
                                            {
                                                "category": "violence",
                                                "definition": "Content that promotes or glorifies violence or celebrates the suffering or humiliation of others.",
                                                "label": "V",
                                                "probability": 0.0009475680999457836
                                            },
                                            {
                                                "category": "sexual",
                                                "definition": "Content meant to arouse sexual excitement, such as the description of sexual activity, or that promotes sexual services (excluding sex education and wellness).",
                                                "label": "S",
                                                "probability": 0.0006652760202996433
                                            },
                                            {
                                                "category": "violence/graphic",
                                                "definition": "Violent content that depicts death, violence, or serious physical injury in extreme graphic detail.",
                                                "label": "V2",
                                                "probability": 0.0005705089424736798
                                            },
                                            {
                                                "category": "harassment",
                                                "definition": "Content that may be used to torment or annoy individuals in real life, or make harassment more likely to occur.",
                                                "label": "HR",
                                                "probability": 0.0005511094350367785
                                            },
                                            {
                                                "category": "sexual/minors",
                                                "definition": "Sexual content that includes an individual who is under 18 years old.",
                                                "label": "S3",
                                                "probability": 0.0004011670534964651
                                            },
                                            {
                                                "category": "hate/threatening",
                                                "definition": "Hateful content that also includes violence or serious harm towards the targeted group.",
                                                "label": "H2",
                                                "probability": 0.000285559450276196
                                            }
                                        ],
                                        "prediction": "OK"
                                    }
                                },
                                "otis": {
                                    "is_spam": true,
                                    "processing_time": 5,
                                    "result": {
                                        "prediction": "Spam",
                                        "probability": 0.9999674558639526
                                    }
                                },
                                "roberta": {
                                    "is_spam": true,
                                    "processing_time": 489,
                                    "result": "Spam"
                                },
                                "sentiment": {
                                    "processing_time": 20,
                                    "result": {
                                        "label": "Very Negative",
                                        "score": 0.549851655960083
                                    }
                                }
                            },
                            "spam_detections_count": 2,
                            "spam_detectors_count": 4
                        }
POST https://spam.audent.ai/{model}
Run analysis using a specific AI model. Replace {model} with: bert, bertsms, koala, otis, roberta, detoxify, or sentiment

Available Models

  • /bert - BERT MoE spam detection
  • /bertsms - BERT Tiny SMS optimization
  • /koala - Content safety analysis
  • /otis - Advanced spam intelligence
  • /roberta - Enterprise-grade detection
  • /sentiment - Multilingual sentiment analysis
  • /detoxify - Toxicity analysis
POST https://spam.audent.ai/detoxify
Analyze text for toxicity using the Detoxify model. This model provides detailed probabilities for various toxicity categories, including threats, insults, and obscene language.

Request Body

JSON
{
  "text": "Your text content to analyze"
}

Example Response

200 OK - Success 200
{
  "processing_time": 482,
  "result": {
    "prediction": {
      "label": "toxicity",
      "probability": 0.9977
    },
    "details": [
      { "label": "toxicity", "probability": 0.9977 },
      { "label": "severe_toxicity", "probability": 0.6995 },
      { "label": "obscene", "probability": 0.9852 },
      { "label": "threat", "probability": 0.0449 },
      { "label": "insult", "probability": 0.9720 },
      { "label": "identity_attack", "probability": 0.9054 },
      { "label": "sexual_explicit", "probability": 0.0001 }
    ]
  }
}

โŒ Error Responses

Rate Limit Exceeded 429
{
  "error": "Rate limit exceeded",
  "message": "Please wait before making another request",
  "retry_after": 5
}
Invalid Request 400
{
  "error": "Invalid request",
  "message": "Missing required field: text"
}

๐Ÿค– AI Models Overview

Each AI model in our suite is specifically designed and optimized for different aspects of content analysis. Choose the right model for your use case or use our comprehensive analysis for complete coverage.

๐Ÿš€ Otis
Advanced anti-spam intelligence designed to combat malicious content in digital communications with 99.9%+ accuracy.
Precision Detection Malicious Content Ultra-Fast
๐Ÿ›ก๏ธ RoBERTa
Enterprise-grade spam detection protecting against financial losses and reputational harm with advanced link protection.
Enterprise Ready Link Protection Business Critical
๐Ÿง  BERT MoE v2.2
State-of-the-art BERT with Mixture of Experts architecture. Multiple specialized sub-models handle diverse spam patterns.
Mixture of Experts Pattern Recognition High Scalability
๐Ÿ“ฑ BERT Tiny SMS
Lightweight BERT optimized for SMS and short messages. Perfect balance of accuracy and speed for mobile applications.
SMS Optimized Lightning Speed Resource Efficient
๐Ÿจ Koala AI
Advanced DeBERTa-v3 content moderation across 9 safety categories including hate speech, violence, and harassment detection.
9 Safety Categories Community Protection Ethical AI
๐ŸŒ Sentiment Analysis
Multilingual sentiment analysis supporting 20+ languages with 5-class precision from Very Negative to Very Positive.
20+ Languages 5-Class Analysis Cultural Context
๐Ÿงช Detoxify
Advanced toxicity detection model that identifies harmful content across multiple categories, including threats, insults, and obscene language.
High Accuracy Detailed Analysis Multilingual Support

โฑ๏ธ Rate Limits & Usage

Our API implements intelligent rate limiting based on your subscription tier. Rate limits are determined by your API key and reset every minute.

Plan Requests per Minute Requests per Day Concurrent Requests Response Time SLA
Demo 1 requests (1 every 5s) 500 1 Best Effort
Starter 60 1,500 3 < 2 seconds
Professional 120 10,000 10 < 1 second
Enterprise 1,000 Unlimited 25 < 600ms

๐Ÿ“Š Rate Limit Headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1640995200

๐Ÿšซ Handling Rate Limits

When you exceed your rate limit, the API returns a 429 Too Many Requests status. Implement exponential backoff for optimal performance:

JavaScript
async function makeAPIRequest(text, retries = 3) {
  for (let i = 0; i < retries; i++) {
    try {
      const response = await fetch('https://spam.audent.ai/check', {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'X-API-KEY': 'your-api-key'
        },
        body: JSON.stringify({ text })
      });
      
      if (response.status === 429) {
        const retryAfter = response.headers.get('Retry-After') || Math.pow(2, i);
        await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
        continue;
      }
      
      return await response.json();
    } catch (error) {
      if (i === retries - 1) throw error;
    }
  }
}

๐Ÿ’ฐ Pricing Plans

Choose the perfect plan for your needs. All plans include access to our complete AI model suite with different rate limits and support levels.

๐Ÿ†“ Demo
Free
  • 1 request per 5 seconds
  • 500 requests per day
  • All 6 AI models
  • Self help support
  • Perfect for testing
Get Started
๐Ÿš€ Starter
$20/1k requests
  • 60 requests per minute
  • 1,000 requests per day
  • All 6 AI models
  • Email support
  • API documentation
  • 99.5% uptime SLA
Choose Starter
๐Ÿข Enterprise
Custom
  • 1,000+ requests per minute
  • Unlimited daily requests
  • All 6 AI models
  • 24/7 dedicated support
  • On-premise deployment
  • 99.99% uptime SLA
  • Custom model training
  • White-label options
Contact Sales

๐Ÿ’ณ Payment & Billing

  • Flexible Billing - Monthly or annual plans with discounts
  • No Setup Fees - Get started immediately with any paid plan
  • Usage Monitoring - Real-time dashboard to track your API usage
  • Overage Protection - Automatic scaling or request queuing options
  • Enterprise Volume Discounts - Custom pricing for high-volume users

๐Ÿš€ Ready to Get Started?

Join thousands of developers using Veritas AI to protect their applications from spam and harmful content.

Live Demo Contact Sales

Questions? Email us at [email protected] or see our other services