API v1.0 — Production Ready

TrueCheckIA API

Detect AI-generated content at scale. Integrate our multi-layer analysis technology into your applications with just a few lines of code.

Get Free API Key View Documentation

99.2%

Accuracy

<2s

Avg. Latency

Analysis Layers

99.9%

Uptime

Get Started in 3 Steps

Integrate AI detection into your application in less than 5 minutes

Create Your Account

Install the SDK

Use our SDK or make direct calls via cURL, Python, or JavaScript

Make Your First Analysis

Submit an image or video and receive detailed results in seconds

Authentication

All API requests must include your API Key in theAuthorization header.

Bearer Token: Use the formatBearer YOUR_API_KEY

HTTPS Required: All requests must use HTTPS

Never expose: Do not include your API Key in frontend code

Header Examplehttp

GET /api/v1/status/job_123 HTTP/1.1
Host: api.truecheckia.com
Authorization: Bearer tcia_live_abc123xyz789...
Content-Type: application/json

Code Examples

analyze.pypython

import requests

API_KEY = "YOUR_API_KEY"

# Analyze an image
response = requests.post(
    "https://api.truecheckia.com/v1/analyze",
    headers={"Authorization": f"Bearer {API_KEY}"},
    files={"file": open("image.jpg", "rb")},
    data={"type": "image"}
)

result = response.json()
print(f"AI Score: {result['score']}%")
print(f"Recommendation: {result['recommendation']}")

Endpoints

POST/api/v1/analyze

Submit an image or video for AI content analysis

Parameters

fileFile (multipart)

type"image" | "video"

asyncboolean (optional)

Response

{
  "success": true,
  "jobId": "job_abc123",
  "status": "processing"
}

GET/api/v1/status/:jobId

Check the status of an ongoing analysis

Use this endpoint to check if the analysis has completed. The status can be: queued,processing,completed orfailed.

curl https://api.truecheckia.com/v1/status/job_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/v1/result/:jobId

Get the complete analysis results

Returns detailed results including score, evidences, and recommendation.

Complete Responsejson

{
  "success": true,
  "jobId": "job_abc123xyz",
  "status": "completed",
  "result": {
    "score": 87,
    "confidence": "HIGH",
    "recommendation": "REJECT",
    "isAiGenerated": true,
    "evidences": [
      {
        "type": "AI_DETECTOR_CONSENSUS",
        "severity": 0.9,
        "description": "Multiple detectors agree: likely AI-generated",
        "layer": "ai_ensemble"
      },
      {
        "type": "VISUAL_NOISE_UNIFORM",
        "severity": 0.7,
        "description": "Uniform noise pattern detected",
        "layer": "visual"
      }
    ],
    "processingTimeMs": 2340
  }
}

Evidence Types

Our multi-layer analysis detects various types of evidence that indicate whether the content was generated by AI:

Layer 1: Metadata

Missing EXIFIncorrect signatureInvalid timestamp

Layer 2: Visual

Uniform noisePerceptual hashInconsistent compression

Layer 3: Semantic

Abnormal facial anatomyInconsistent lightingImpossible physics

Layer 4: AI Ensemble

Detector consensusGPT-4V scoreHeuristic analysis

Layer 5: Provenance

Hash matchingKnown imageReverse search

Layer 6: Statistical

Name patternTypical AI dimensionsBatch upload

Official SDKs

Use our official SDKs to integrate the TrueCheckIA API into your application quickly and securely.

Python

v1.0.0

pip install truecheckiaView on GitHub

Node.js

v1.0.0

npm install @truecheckia/sdkView on GitHub

PHP

v1.0.0

composer require truecheckia/sdkView on GitHub

Ruby

v1.0.0

gem install truecheckiaView on GitHub

Sandbox Environment

Use our test environment to develop and test your integration at no cost. Test API Keys have the prefix tcia_test_.

No cost: All analyses in test mode are free

Isolated data: Test data never affects production

Sample images: Use our test images to validate

Using Test API Keybash

# Test Environment
curl -X POST https://sandbox.truecheckia.com/v1/analyze \
  -H "Authorization: Bearer tcia_test_abc123..." \
  -F "file=@test_image.jpg"

# Simulated response with sample data
{
  "success": true,
  "jobId": "test_job_xyz",
  "environment": "sandbox"
}

Error Reference

The API uses conventional HTTP codes to indicate the success or failure of requests.

Code	Name	Description
200	OK	Request processed successfully
201	Created	Resource created successfully
400	Bad Request	Invalid or missing parameters
401	Unauthorized	Invalid or missing API Key
403	Forbidden	No permission for this resource
404	Not Found	Resource not found
429	Rate Limited	Request limit exceeded
500	Server Error	Internal server error

Error Response Example

{
  "success": false,
  "error": {
    "code": "invalid_api_key",
    "message": "The provided API Key is invalid or expired.",
    "doc_url": "https://docs.truecheckia.com/errors/invalid_api_key"
  }
}

Webhooks

Pro

Receive real-time notifications when analyses are completed. Configure webhooks in your dashboard to receive events automatically.

Available Events

analysis.completed—Analysis finished successfully

analysis.failed—Analysis failed or timed out

batch.completed—Batch of analyses completed

quota.warning—Usage quota reaching limit

Payload Example

{
  "id": "evt_abc123",
  "type": "analysis.completed",
  "created": 1705766400,
  "data": {
    "jobId": "job_xyz789",
    "score": 87,
    "recommendation": "REJECT"
  }
}