~/docs cat ai-image-detection.md

AI-image detection

POST /api/defence/ai-image-detection/detect-file — detect whether an image is AI-generated.

Request: file (binary, required); optional save ("false" to skip persistence), usecase_environment (JSON, e.g. {"threshold":0.5}) and ai_model_info (JSON caller metadata).

curl

curl -X POST "https://api.scam.ai/api/defence/ai-image-detection/detect-file" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "file=@/path/to/image.jpg" \
  -F 'usecase_environment={"threshold":0.5}'

response fields

task_id      string   unique task identifier
detected     boolean  true if likely AI-generated
confidence   float    0.0–1.0 AI-generation confidence
result.payload
  .likely_ai_generated    verdict against the configured threshold
  .confidence_score       raw model confidence
  .threshold_used         detection threshold applied (default 0.5)
  .processing_time_ms     model inference time
file_info    object   original_filename, file_size, mime_type, uploaded_at
credits_used integer  1 per image

This is the engine behind Check if AI.

← Deepfake / face-swap Document forgery →