Get Started in 3 Steps
Step 1: Get an API Key
Sign up at trybijou.com
Go to Profile → API Keys
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
Python
TypeScript/JavaScript
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
Verdict Score Meaning ai_generated>= 0.7 High confidence the image is AI-generated uncertain0.4 - 0.7 Inconclusive - manual review recommended likely_real< 0.4 High 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
Action Cost API detection 1 credit Web detection Free (5/day)
Credits cost $0.01 each. Buy credits →
Next Steps