API Dokumentation

Schnellstart-Anleitung für die ImageScan API.

Authentifizierung

Alle API-Anfragen erfordern einen API-Key im Header:

X-API-Key: is_your_api_key_here

Analyze Endpoint

POST /api/v1/analyze

Bild per URL

curl -X POST https://imagescan.de/api/v1/analyze \
  -H "X-API-Key: is_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/image.jpg"}'

Bild per Upload

curl -X POST https://imagescan.de/api/v1/analyze \
  -H "X-API-Key: is_your_key" \
  -F "file=@/path/to/image.jpg"

Response Format

{
  "hash_sha256": "abc123...",
  "category": "safe",
  "is_explicit": false,
  "confidence": 0.98,
  "detections": {
    "nudity": 0.02,
    "violence": 0.01
  },
  "processing_time_ms": 127,
  "cached": false
}

Kategorien

safe Unbedenklicher Inhalt
suggestive Anzüglicher Inhalt
explicit Expliziter Inhalt

Rate Limits

Rate Limit Informationen werden in den Response Headers zurückgegeben:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1703376000

Fehlercodes

401

Unauthorized

Ungültiger oder fehlender API-Key

429

Too Many Requests

Rate Limit überschritten

400

Bad Request

Ungültiges Bildformat oder fehlendes Bild

Bereit loszulegen?

Kontaktiere uns für einen API-Zugang.

Kontakt aufnehmen