README.md

---
title: DeepShield API
emoji: 🛡️
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
short_description: Multi-API ensemble AI image detector
---

# DeepShield Detection API

FastAPI backend for AI-generated image detection.

## Endpoints

- `GET /health` — liveness probe
- `GET /detectors` — list active detectors
- `POST /analyze` — upload image, get ensemble verdict
- `GET /history` — analysis history (requires MongoDB)

## Configuration

Set the following as Space **Secrets** (Settings → Variables and secrets):

| Key | Required | Purpose |
|-----|----------|---------|
| `SIGHTENGINE_API_USER` | yes | Sightengine API user |
| `SIGHTENGINE_API_SECRET` | yes | Sightengine API secret |
| `GOOGLE_API_KEY` | no | Enables Gemini detector |
| `ANTHROPIC_API_KEY` | no | Enables Claude detector |
| `MONGODB_URL` | no | Enables history persistence |

Public env vars (Variables tab) control which detectors are enabled — see the project's `DEPLOY.md`.