Getting Started

Welcome to itsreal.media! This guide will help you get started with our AI image detection and website verification platform.

  1. 1

    Sign Up

    Create your account at app.itsreal.media using your email or social login

  2. 2

    Choose Your Workflow

    Select between individual image analysis or complete website verification based on your needs

  3. 3

    Upload & Analyze

    Upload your images or submit website URLs for AI-powered analysis and verification

  4. 4

    Review Results

    Get detailed analysis reports and certification badges (work in progress) for your content

Account Setup

Setting up your account takes less than a minute. Here's what you need to get started.

  1. 1

    Create an Account

    Visit app.itsreal.media and sign up with your email address or social login

  2. 2

    Verify Your Email

    Check your inbox for a verification email and confirm your account

  3. 3

    Access Your Dashboard

    Once verified, log in to access your dashboard where you can start analyzing images and verifying websites

AI Image Detection

Upload individual images to detect AI-generated content, deepfakes, and synthetic media using our advanced detection algorithms.

🤖

AI Detection

Detects GANs, diffusion models, and synthetic media using advanced ML algorithms.

⚡

Fast Processing

Get accurate results in seconds with our optimized detection pipeline.

📈

Confidence Score

Detailed confidence scores and probability assessments for reliable analysis.

How to Analyze Images

  1. 1

    Go to Image Detection

    Navigate to the "AI Image detection" tab in your dashboard or click "ADD NEW IMAGE"

  2. 2

    Upload Your Image

    Click the upload area and select your image file. Supported formats include JPG, PNG, and WebP

  3. 3

    Start Analysis

    Click "Analyze Image" to begin the AI detection process

  4. 4

    Review Results

    View detailed analysis results including detection confidence, specific AI indicators, and technical details

Supported Formats

JPG, PNG, WebP. Min resolution: 256x256 pixels. Max file size: 10MB

Website Certification

Verify entire websites for AI-generated content and receive certification badges to build trust with your audience. (Work in progress)

How to Verify Your Website

  1. 1

    Navigate to Site Verification

    Go to the "Site verification" tab in your dashboard or click "ADD NEW SITE"

  2. 2

    Enter Website URL

    Provide the complete URL of the website you want to verify (e.g., https://www.yoursite.com)

  3. 3

    Submit for Analysis

    Click "Submit" to start the automated crawling and analysis process

  4. 4

    Monitor Progress

    Track the analysis progress in your dashboard. Large sites may take several minutes to process

  5. 5

    Review Results

    Once complete, view your detailed report and download your certification badge

Pro Tip

For best results, ensure your website is publicly accessible and doesn't require authentication. Our crawler needs to access your images to analyze them.

Detection Models

Learn about the AI models and technologies powering itsreal.media's detection capabilities.

🔬

Model Architecture

Advanced deep learning models trained on diverse datasets for robust AI detection.

📊

Training Data

Comprehensive training on real and synthetic images from various generation methods.

🔄

Continuous Updates

Regular model improvements to stay ahead of emerging AI generation techniques.

Coming Soon

Detailed technical documentation about our detection models, performance metrics, and research papers will be available soon.

API Reference

Integrate itsreal.media's detection capabilities into your own applications using our REST API. Full interactive docs also available on Swagger UI.

Get API Key Open Swagger UI
Base URL: https://api.itsreal.media

Authentication

The API supports two authentication methods. Use API keys for server-to-server integrations and Bearer tokens for user-facing apps.

API Key

For server-to-server communication. Pass your key in the Authorization header with the Token prefix.

Bearer Token (JWT)

OAuth 2.0 access token for web applications and user-facing interfaces. Use the Bearer prefix.

Authorization: Token your_api_key_here Authorization: Bearer your_jwt_token_here

API Key Management

Returns a list of all API keys associated with your account.

Response 200
{ "tokens": [ { "id": 1, "key": "abc123...xyz", "created": "2026-01-15T10:30:00Z" } ] }

Generate a new API key for programmatic access.

Response 201
{ "message": "Token created successfully", "key": "your_new_api_key" }

Revoke an existing API key. This action cannot be undone.

Response 204

No content returned on success.

Analyze

The primary endpoint for AI image detection. Upload an image and get instant analysis results.

Upload and analyze an image to determine if it's real or AI-generated. Supports JPEG, PNG, and WebP formats up to 10 MB.

Request Body — multipart/form-data
ParameterTypeDescription
file required binary Image file to analyze (JPEG, PNG, WebP, max 10 MB)
Response 200
{ "status": "analyzed", "fully_gen_label": "real" | "ai-generated", "fully_gen_confidence": 0.97, "partially_mod_label": "real" | "partially-modified", "partially_mod_confidence": 0.85, "reason": "model-prediction" | "ai-metadata", "generators": { } }
Error Responses
StatusDescription
400Invalid file type, file too large, or missing file
401Unauthorized — invalid or missing token
504Gateway Timeout — analysis timed out

Quick Example

curl -X POST https://api.itsreal.media/api/v1/analyze/ \ -H "Authorization: Token YOUR_API_KEY" \ -F "file=@image.jpg"

Images

Manage uploaded images in your account. List, upload, retrieve, and delete images.

Returns a paginated list of all images in your account.

Query Parameters
ParameterTypeDescription
limit integer Number of results per page
offset integer Starting index for pagination
Response 200
{ "count": 42, "next": "https://api.itsreal.media/api/v1/images/?limit=20&offset=20", "previous": null, "results": [ /* Image objects */ ] }

Upload a new image via file or remote URL.

Request Body — multipart/form-data
ParameterTypeDescription
file binary Image file to upload
file_url string (URI) Remote image URL (alternative to file upload)
label required string Label for the image (max 255 chars)
Response 201
{ "id": "uuid", "label": "my-image", "status": "pending", "file": "https://...", "ai_label": null, "report": null, "created_at": "2026-01-15T10:30:00Z", "updated_at": "2026-01-15T10:30:00Z" }

Retrieve a specific image and its analysis results by ID.

Path Parameters
ParameterTypeDescription
id required string (UUID) Image identifier
Image Status Values
StatusDescription
pendingImage uploaded, awaiting analysis
analyzingAnalysis in progress
analyzedAnalysis complete, results available
failedAnalysis failed

Generate a presigned URL for direct S3 upload. Use this for large files or client-side uploads.

Response 200
{ "presigned_url": "https://s3.amazonaws.com/...", "object_key": "uploads/uuid/image.jpg", "expires_in": 3600 }

Permanently delete an image and its analysis data.

Response 204

No content returned on success.

Websites

Submit websites for automated crawling and AI content analysis. Configure scraping depth, frequency, and image limits.

Returns a paginated list of all monitored websites.

Query Parameters
ParameterTypeDescription
limit integer Number of results per page
offset integer Starting index for pagination

Submit a new website for monitoring and analysis.

Request Body
ParameterTypeDescription
url required string (URI) Website URL to analyze
scraping_period_days integer Re-scan interval in days (default: 7)
scraping_depth integer How many links deep to crawl (default: 2)
scraping_max_images integer Maximum images to analyze (default: 1000)
Response 201
{ "id": "uuid", "url": "https://example.com", "scraping_period_days": 7, "scraping_depth": 2, "scraping_max_images": 1000, "images": "...", "scraping_job": "...", "certificate": null, "report": null, "created_at": "2026-01-15T10:30:00Z" }

Retrieve details and analysis status for a specific website.

Remove a website and all associated analysis data.

Response 204

No content returned on success.

Check if the scraper bot is allowed to access a website according to its robots.txt rules.

Request Body
ParameterTypeDescription
url required string (URI) Website URL to check
Response 200
{ "allowed": true, "reason": "No restrictions found in robots.txt" }

Certificates

Public endpoint for viewing website certification results. No authentication required.

View a public website certificate showing AI content analysis results. This endpoint does not require authentication.

Path Parameters
ParameterTypeDescription
token required string Certificate token
Response 200
{ "token": "abc123", "website_url": "https://example.com", "type": "real_content" | "ai_labeled" | "audited", "issued_at": "2026-01-15T10:30:00Z", "expires_at": "2026-07-15T10:30:00Z", "active": true, "verify_url": "https://api.itsreal.media/api/v1/certificates/abc123/" }

User

Retrieve your account details and current usage quota.

Returns your account details including usage quota information.

Response 200
{ "id": 1, "email": "user@example.com", "username": "user123", "first_name": "Jane", "last_name": "Doe", "quota_limit": 1000, "quota_used": 42, "quota_reset_at": "2026-02-01T00:00:00Z" }

Health & Status

GET /api/v1/health/ — Basic availability check (returns status + version).
GET /api/v1/status/ — Detailed status with service health (database, cache). No auth required.

Troubleshooting & FAQ

Common issues and solutions to help you get the most out of itsreal.media.

Website analysis time depends on several factors: the number of images on your site, image file sizes, and server response times. Large websites with many high-resolution images may take 10-30 minutes to process completely. You can monitor progress in your dashboard.

Typical processing times: Small sites (1-10 images): 1-3 minutes | Medium sites (10-50 images): 5-15 minutes | Large sites (50+ images): 15-30 minutes

Our crawler can only access publicly available content. If your website requires login or has restricted access, we won't be able to analyze it. Consider making a public version of your content available for analysis, or use our individual image upload feature instead.

Image uploads can fail due to file size limits (max 10MB), unsupported formats, or network issues. Ensure your image is in JPG, PNG, or WebP format and under 10MB. Try refreshing the page and uploading again.

Our AI detection models achieve high accuracy rates (typically >95%) but no system is perfect. Results should be used as a guide rather than absolute truth. Consider the confidence scores and use multiple verification methods for critical decisions.

Yes, you can re-analyze both individual images and entire websites. Simply upload the image again or resubmit the website URL. Note that this will create a new analysis record in your history.

If you're experiencing issues not covered here, please contact our support team at support@itsreal.media or use the contact form on our website. We typically respond within 24 hours.