Ein klar abgegrenzter Endpunkt
Fügen Sie einer JSON-Anfrage eine Textzeichenfolge und die Detektorversion hinzu. Für die grundlegende Integration muss kein SDK synchron gehalten werden.
REST-API / KI-Erkennung
KI-Detektor-API für nachvollziehbare Prüfsignale
Senden Sie Text an einen einzigen HTTPS-Endpunkt und integrieren Sie die Analyse von KI-Texten in Ihr Produkt. Detector v3 liefert strukturierte Daten, die Ihr Team prüfen, speichern und im Zusammenhang erklären kann.
Verwenden Sie den Schlüssel in einer privaten Serverumgebung.
cURL-Anfrage
curl --request POST \
--url https://api.detecting-ai.com/api/detect/ \
--header "Content-Type: application/json" \
--header "Idempotency-Key: detector-review-001" \
--header "X-API-Key: YOUR_API_KEY" \
--data '{
"text": "Paste the text you want to analyze.",
"version": "v3"
}'01
POST-Anfragen an /api/detect/
02
Authentifizierung mit X-API-Key
03
Clientseitiger Idempotency-Key für sicher wiederholbare Anfragen
04
Detector v3 für neue Integrationen
05
Anfrage und Antwort als JSON
Für echte Prüfabläufe entwickelt
Ein schlanker API-Vertrag mit Raum für sorgfältige Entscheidungen
Die Integration bleibt einfach: Ihr Server sendet den Text, der Detektor analysiert ihn und Ihre Oberfläche entscheidet über die Darstellung des Ergebnisses. Diese Trennung erleichtert Tests und überlässt die endgültige Entscheidung einem Menschen.
Strukturierte Ausgabe
Lesen Sie Detektordetails, Version und Anzahl der verarbeiteten Wörter aus der Antwort, anstatt eine Webseite auszulesen.
Die menschliche Prüfung bleibt sichtbar
Nutzen Sie das Signal, um Passagen und Fälle zu priorisieren. Machen Sie aus einem Modellwert keine automatische Anschuldigung oder Ablehnung.
Anfragevertrag
Zwei Felder genügen für den Einstieg
Senden Sie UTF-8-Text als JSON und wählen Sie die Detektorversion bewusst. Neue Integrationen sollten v3 verwenden.
| Feld | Typ | Erforderlich | Funktion |
|---|---|---|---|
| text | string | Ja | Der Text, den der Detektor analysieren soll. |
| version | string | Ja | Die Detektorversion. Verwenden Sie v3 für eine neue Integration. |
Speichern Sie während der Entwicklung die vollständige Antwort
Protokollieren Sie zunächst die vollständige JSON-Antwort in einer sicheren Testumgebung. Sobald der Vertrag klar ist, ordnen Sie nur die von Ihrem Produkt verwendeten Felder zu und speichern die Anzahl der verarbeiteten Wörter für die Nutzungsaufzeichnung.
Beispielantwort
{
"success": true,
"data": {
"details": {
"result": "Detector analysis is returned here"
},
"version": "v3",
"words_processed": 8
}
}Integrationsablauf
Vom API-Schlüssel zum brauchbaren Ergebnis
Erstellen Sie die Anfrage zuerst auf Ihrem Server. Ergänzen Sie die Produktoberfläche erst, wenn der reguläre Ablauf und die Fehlerfälle klar sind.
- 1
Schlüssel vorbereiten, speichern und aktivieren
Bereiten Sie im Dashboard einen Schlüssel vor, kopieren Sie den einmal sichtbaren Wert in eine serverseitige Geheimnisverwaltung, bestätigen Sie die Speicherung und aktivieren Sie ihn. Nach der Aktivierung wird der vollständige Wert nicht erneut angezeigt.
- 2
Eine repräsentative Probe senden
Senden Sie realistischen Text per POST mit Version v3 und speichern Sie vor dem Versand einen eindeutigen Idempotency-Key. Verwenden Sie ihn nur für die identische Wiederholung einer Anfrage.
- 3
Die Hinweise sorgfältig darstellen
Überführen Sie die strukturierte Antwort in einen klaren Prüfstatus und geben Sie einem Menschen Raum, Text und Kontext zu betrachten.
Geeignete Einsätze
Nützlich, wenn Text bereits eine Prüfwarteschlange durchläuft
Die API eignet sich am besten als eines von mehreren Signalen in einem bestehenden Entscheidungsprozess. Sie soll Menschen zeigen, wo sie genauer hinsehen sollten, nicht die Entscheidung für sie treffen.
Erkennung ist kein Beweis für die Urheberschaft
Modelle können sich irren, besonders bei kurzen, stark bearbeiteten, übersetzten oder formelhaften Texten. Überlassen Sie folgenreiche Entscheidungen keinem vollständig automatischen Ablauf.
Redaktionelle Eingangsprüfung
Ergänzen Sie eingereichte Entwürfe um ein Urheberschaftssignal und leiten Sie ungewöhnliche Fälle zur genaueren Lektüre an eine Redaktion weiter.
Bildungsplattformen
Zeigen Sie ein Prüfsignal zusammen mit Aufgabenkontext, Überarbeitungsverlauf, Quellen und den eigenen Richtlinien der Einrichtung an.
Interne Moderation
Prüfen Sie übermittelten Text in einem privaten Ablauf, ohne den API-Schlüssel an den Browser zu senden.
Stapelweise Vorauswahl
Verarbeiten Sie wartende Dokumente auf dem Server und heben Sie Fälle hervor, die eine zweite manuelle Prüfung verdienen.
API-FAQ
Praktische Antworten vor dem Produktivstart
Beginnen Sie mit einer serverseitigen Anfrage, protokollieren Sie die Antwortstruktur und fügen Sie das Ergebnis dann Ihrem bestehenden Prüfablauf hinzu.
Welchen Endpunkt verwendet die KI-Detektor-API?+
Senden Sie eine POST-Anfrage an https://api.detecting-ai.com/api/detect/. Der Anfragekörper ist JSON, die Authentifizierung verwendet X-API-Key und neue Integrationen sollten für jeden logischen Vorgang einen stabilen Idempotency-Key speichern.
Welche Detektorversion sollte eine neue Integration verwenden?+
Verwenden Sie v3 für neue Integrationen. Die Version wird im JSON-Anfragekörper übermittelt, damit das Verhalten ausdrücklich festgelegt und leicht testbar ist.
Kann ich die API direkt aus JavaScript im Browser aufrufen?+
Legen Sie einen privaten API-Schlüssel niemals im Browsercode offen. Senden Sie Anfragen von Ihrem Server, einer Edge-Funktion oder einer anderen vertrauenswürdigen Umgebung und geben Sie nur das von Ihrer Oberfläche benötigte Ergebnis zurück.
Beweist ein KI-Wert, wer den Text geschrieben hat?+
Nein. KI-Erkennung liefert ein probabilistisches Signal. Richten Sie die Prüfung damit auf bestimmte Textstellen und berücksichtigen Sie anschließend Entwürfe, Quellen, Schreibverlauf und Kontext.
Wo kann ich die API-Nutzung und die verbleibenden Wörter prüfen?+
Das API-Dashboard zeigt das mit Ihrem Abonnement verbundene Guthaben. Jede erfolgreiche Detektoranfrage meldet die Anzahl der verarbeiteten Eingabewörter.
Erste Anfrage erstellen
Führen Sie eine Testanfrage aus, bevor Sie den Ablauf gestalten
Verwenden Sie Detector v3, bewahren Sie den Schlüssel auf Ihrem Server auf und prüfen Sie die vollständige JSON-Antwort mit Text, der Ihren echten Eingaben ähnelt.