Developer Portal

Everything developers need.

Docs, SDKs, API keys & dashboards

Your unified hub for building with Real-Lenses. Generate API keys, read documentation, monitor usage, configure webhooks, and download SDKs — all in one place.

Open the portal See pricing

REST

API standard

4

SDKs

99.9%

Uptime

<3s

Avg latency

Features

A complete developer experience.

API key management

Generate, rotate, and revoke API keys. Set custom scopes, rate limits, and IP allowlists per key.

Interactive docs

Try API endpoints directly in the browser. Code samples in Python, JS, Go, Ruby, and curl.

Usage dashboard

Real-time API usage, error rates, latency histograms, and per-key analytics.

Webhook manager

Register webhook endpoints, test deliveries, view event logs, and replay failed events.

Code generator

Generate ready-to-use code snippets for common operations in your preferred language.

Sandbox mode

Test mode with mock responses. No credits consumed. Perfect for development and CI/CD pipelines.

FAQ

How do I get started?

Sign up, go to the API Dashboard, generate a key, and check the API Reference below. You'll be making API calls in under 5 minutes.

Is there a free tier?

Yes. Free tier includes 10 analyses per month with full access to all endpoints. No credit card required.

Can I use the API in production?

Yes. Upgrade to a paid plan (Starter $99/mo or Pro $299/mo) for production access with higher rate limits, SLAs, and priority support.

Do you offer technical support?

Free tier gets community support. Pro and Enterprise plans get email and priority support. Enterprise includes a dedicated technical account manager.

Ready to get started?

Join thousands using Real-Lenses to verify the truth.

Open the portal

API Reference

Real-Lenses API documentation

Send media to our forensic engine and get back a verdict, confidence score, and indicators — in under 10 seconds.

Authentication

Create an account and subscribe to any paid plan (Starter, Pro, or Enterprise).
Go to /api-dashboard and generate an API key.
Your key starts with rl_live_. Store it securely — it's shown only once.
Pass it in the Authorization header as a Bearer token on every request.

Authorization: Bearer rl_live_your_key_here

Never expose your API key in client-side code or public repositories. Use environment variables on your server.

Base URL

https://real-lenses.base44.app/functions

All endpoints are relative to this base URL. Append the function name (e.g. /analyzeMedia).

Starter

100/min

Pro

500/min

Enterprise

Custom

Endpoints

POST/analyzeMediaAPI key + active subscription

Analyze an image, video, or audio file for AI-generation or manipulation. Returns a verdict, confidence score, and indicators.

curl -X POST "https://real-lenses.base44.app/functions/analyzeMedia" \
  -H "Authorization: Bearer YOUR_API_KEY" \ \
  -H "Content-Type: application/json" \
  -d '{"file_url":"https://example.com/photo.jpg","report_language":"en"}'

Response (200 OK)

{
  "verdict": "real | edited | ai_generated",
  "confidence": 0.94,
  "summary": "No manipulation detected...",
  "indicators": [
    "..."
  ]
}

POST/factCheckClaimAPI key + active subscription

Fact-check a text claim against live web sources. Returns a verdict and supporting evidence.

curl -X POST "https://real-lenses.base44.app/functions/factCheckClaim" \
  -H "Authorization: Bearer YOUR_API_KEY" \ \
  -H "Content-Type: application/json" \
  -d '{"claim":"The sky is green."}'

Response (200 OK)

{
  "verdict": "false",
  "confidence": 0.99,
  "evidence": [
    "..."
  ]
}

POST/generateApiKeyAuthenticated user session

Generate a new API key for your account. Returns the full key once — store it securely.

curl -X POST "https://real-lenses.base44.app/functions/generateApiKey" \
  -H "Authorization: Bearer YOUR_API_KEY" \ \
  -H "Content-Type: application/json" \
  -d '{"name":"Production Server"}'

Response (200 OK)

{
  "key": "rl_live_...",
  "key_prefix": "rl_live_abc"
}

GET/getPublicStatsNone (public)

Retrieve aggregate public platform statistics — total analyses, verdict distribution, growth.

curl -X GET "https://real-lenses.base44.app/functions/getPublicStats" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (200 OK)

{
  "total_analyses": 2400000,
  "verdict_distribution": {
    "real": 60,
    "edited": 25,
    "ai_generated": 15
  }
}

Error codes

401Missing or invalid API key

403Key valid but subscription inactive or limit exceeded

422Invalid file URL or unsupported media type

429Rate limit exceeded — retry with backoff

500Server error — safe to retry