API-Dokumentation

Integrieren Sie DeepSense™ KI-Erkennung in Ihre Anwendung. RESTful JSON API mit einfacher schlüsselbasierter Authentifizierung.

🎛️ Sensitivitätsmodi

Wählen Sie die Erkennungsstrenge, die zu Ihrem Anwendungsfall passt. Übergeben Sie den sensitivity-Parameter in Ihrer Anfrage.

Modus	KI-Erkennung	Falsch-Positive	Am besten für
conservative	Moderat	Sehr Gering	Studenten-Selbstprüfung, minimales Risiko falscher Beschuldigungen
balanced	Hoch	Gering	Content-Plattformen, Business-Standard
aggressive	Sehr Hoch	Moderat	Stapelprüfung mit menschlicher Überprüfung

Authentifizierung

Alle Anfragen erfordern einen API-Key, der als HTTP-Header übergeben wird. Erhalten Sie einen Key auf der Preisseite.

// Alle Anfragen:
X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Ungültige oder fehlende Keys geben 401 zurück. Ratenbegrenzte Anfragen geben 429 mit Retry-Headern zurück.

Ratenlimits & Header

Plan	Wörter/Monat	~Aufsätze
Free	10,000	~50 essays
Essential	60,000	~300 essays
Premium	180,000	~900 essays
Professional	360,000	~1,800 essays
Enterprise	15,000,000	~75,000 essays

Jede Antwort enthält Ratenlimit-Header (Wortanzahl):

X-RateLimit-Limit: 200000
X-RateLimit-Remaining: 183700

Endpunkte

POST /api/detect

Text auf KI-generierte Inhalte analysieren. Mindestens 20 Wörter.

Anfrage

// POST /api/detect
Content-Type: application/json
X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

{
  "text": "The rapid advancement of deep learning techniques has...",
  "sensitivity": "balanced"  // optional: conservative | balanced | aggressive
}

Parameter

Feld	Typ	Erforderlich	Beschreibung
text	string	✅	Zu analysierender Text (min. 20 Wörter)
sensitivity	string	—	Erkennungsstrenge: conservative (0% Falsch-Positive), balanced (empfohlen), aggressive (maximale KI-Erkennung). Standard: conservative

Antwort

{
  "success": true,
  "score": 87,
  "verdict": "Likely AI",
  "docTypeLabel": "Academic Paper",
  "totalDimensions": 21,
  "activeDimensions": 15,
  "ms_cost": 12.4,
  "rate_limit": 5000,
  "rate_remaining": 4837,
  "dimensions": [
    {
      "label": "Prosodic Cadence Quotient",
      "detected": true
    }
  ],
  "textAnnotations": [
    {
      "sentence": "Furthermore, it is important...",
      "start": 420,
      "end": 510,
      "dims": [
        { "id": "template_phrases", "label": "..." }
      ]
    }
  ],
  "bullets": [
    {
      "text": "Formulaic sequence tendency detected",
      "example": "It is important to note that...",
      "start": 420,
      "end": 510
    }
  ]
}

Statuscodes

Code	Bedeutung
200	Erkennung abgeschlossen
400	Fehlendes Textfeld oder Text unter 20 Wörtern
401	Ungültiger oder fehlender API-Key
429	Monatliches Kontingent überschritten

POST /api/detect (Stapelverarbeitung)

Mehrere Dateien zur Stapelerkennung hochladen. Gibt NDJSON-Stream zurück.

Anfrage

// POST /api/detect
Content-Type: multipart/form-data
X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

files[]: essay1.txt
files[]: report2.docx
files[]: paper3.pdf

Response (NDJSON stream, 1 line per file)

// Real-time streaming — each line = 1 file result
{"type":"progress","index":0,"fileName":"essay1.txt","total":3"}
{"type":"result","index":0,"fileName":"essay1.txt","score":87,"verdict":"Likely AI","words":450","flagged":7","totalDims":15","docType":"General"}
{"type":"progress","index":1,"fileName":"report2.docx","total":3"}
{"type":"complete","total":3"}

Unterstützte Formate: TXT, MD, DOCX, PDF.

Schnellstart-Beispiele

cURL

# Einfache Erkennung
curl -X POST https://www.anyaizero.com/api/detect \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_your_key_here" \
  -d '{"text":"Your text to analyze for AI content..."}'

# Mit Sensitivität (balanced für Business empfohlen)
curl -X POST https://www.anyaizero.com/api/detect \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_your_key_here" \
  -d '{"text":"...", "sensitivity":"balanced"}'

Python

import requests

response = requests.post(
    "https://www.anyaizero.com/api/detect",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "ak_your_key_here"
    },
    json={"text": "Your text to analyze..."}
)

result = response.json()
print(f"AI Score: {result['score']}% — {result['verdict']}")

JavaScript / Node

const res = await fetch("https://www.anyaizero.com/api/detect", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "ak_your_key_here"
  },
  body: JSON.stringify({ text: "Your text to analyze..." })
});

const data = await res.json();
console.log(`Score: ${data.score}%, Verdict: ${data.verdict}`);

FAQ

Wie wird die Nutzung gezählt?

Die Nutzung wird nach verarbeiteten Wörtern gezählt. Jedes Wort im eingereichten Text zählt zu Ihrem monatlichen Kontingent. Stapel-Uploads zählen die Gesamtwortzahl aller Dateien.

Kann ich mein monatliches Limit überschreiten?

Anfragen geben 429 zurück, wenn das Limit erreicht ist. Kontaktieren Sie uns für ein Upgrade oder zur Besprechung von Überziehungspreisen.

Gibt es einen Sandbox- oder Test-Key?

Kontaktieren Sie api@https://www.anyaizero.com für einen Test-Key mit 500 kostenlosen Test-Aufrufen.

Wie schnell ist die Antwortzeit?

Durchschnittlich 10-80 ms, abhängig von der Textlänge. Keine externen API-Abhängigkeiten — die gesamte Verarbeitung erfolgt intern.

Speichern Sie eingereichte Texte?

Nein. Text wird im Arbeitsspeicher verarbeitet und verworfen. Wir protokollieren nur Metadaten (Wortanzahl, Bewertung, Zeitstempel) zu Abrechnungszwecken.

Fragen? E-Mail an api@https://www.anyaizero.com · Preise