Skip to main content

Get Started in 3 Steps

Step 1: Get an API Key

  1. Sign up at trybijou.com
  2. Go to ProfileAPI Keys
  3. Click Generate and copy your key
Save your API key immediately - you won’t be able to see it again!

Step 2: Install the SDK

pip install bijou

Step 3: Detect Your First Image

from bijou import BijouClient

client = BijouClient(api_key="bijou_your-key")
result = client.detect("path/to/image.jpg")

if result.prediction == "ai":
    print(f"🤖 AI-generated ({result.confidence:.1%} confidence)")
else:
    print(f"📷 Likely real ({result.confidence:.1%} confidence)")

Understanding Results

The API returns detailed detection results:
{
  "prediction": "ai",           // "ai", "real", or "uncertain"
  "confidence": 0.87,           // 0.0 to 1.0
  "verdict": "ai_generated",    // Human-readable verdict
  "ensemble_score": 0.87,       // Weighted score from all models
  "models_succeeded": 5,        // Number of models that ran
  "model_results": {            // Individual model scores
    "aeroblade": {"score": 0.92},
    "univfd": {"score": 0.88},
    "npr": {"score": 0.79},
    "fire": {"score": 0.91},
    "cnnspot": {"score": 0.82}
  }
}

Verdict Meanings

VerdictScoreMeaning
ai_generated>= 0.7High confidence the image is AI-generated
uncertain0.4 - 0.7Inconclusive - manual review recommended
likely_real< 0.4High confidence the image is authentic

Handle Errors

Always handle the case when you run out of credits:
from bijou import BijouClient, BijouInsufficientCreditsError

client = BijouClient(api_key="bijou_your-key")

try:
    result = client.detect("image.jpg")
    print(f"Result: {result.prediction}")
except BijouInsufficientCreditsError:
    print("Out of credits! Buy more at trybijou.com/profile")

Pricing

ActionCost
API detection1 credit
Web detectionFree (5/day)
Credits cost $0.01 each. Buy credits →

Next Steps