KI-Detektor-API und MCP-Dokumentation

Zugriff

Authentifizierung

REST-Anfragen und lokale MCP-Clients verwenden Kunden-API-Schlüssel in unterschiedlichen Headern. Gehostete MCP-Konnektoren erkennen OAuth und öffnen einen Autorisierungsablauf im Browser.

Sichere Nutzung

Eine Anfrage wiederholen, ohne doppelt abgerechnet zu werden

Neue Integrationen sollten für jede logische REST-Anfrage einen eindeutigen Idempotency-Key senden und diesen Wert aufbewahren, bis die Anfrage gelingt oder aufgegeben wird. Bricht die Verbindung ab, wiederholen Sie exakt denselben Endpunkt mit demselben Text, derselben Version oder demselben Modell und Schlüssel. Eine identische Wiederholung gibt die gespeicherte Antwort zurück, ohne den Anbieter erneut auszuführen oder die Wörter nochmals abzuziehen.

Solange der erste Aufrufer noch das Provider-Lease besitzt, gibt eine identische gleichzeitige Wiederholung HTTP 409 mit Retry-After zurück. Nach Abschluss bleibt die exakte Antwort 24 Stunden lang abrufbar. Ist dieser private Inhalt abgelaufen, gibt derselbe Schlüssel HTTP 410 zurück. Die dauerhafte Sperrmarke verhindert weiterhin eine zweite Belastung.

REST-Endpunkt

KI-Detektor-API

Analysieren Sie übermittelten Text auf Muster, die mit KI-verfassten Texten in Verbindung stehen. Ergebnisse sind probabilistische Prüfsignale und kein Beweis für die Urheberschaft.

Anfragekörper

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"
  }'

Antwort

{
  "success": true,
  "data": {
    "details": {
      "chunks": [
        {
          "text": "A sentence from the input.",
          "startChar": 0,
          "endChar": 26,
          "type": "AI",
          "score": 0.87
        }
      ],
      "ai_percentage": 42.5
    },
    "version": "v3",
    "words_processed": 120
  }
}

Übersicht zur KI-Detektor-API lesen

REST-Endpunkt

KI-Humanizer-API

Schreiben Sie übermittelten Text mit einem ausgewählten Humanizer-Modell um. Die Ausgabe ist bearbeitbar und sollte auf Bedeutung, Fakten, Namen, Links, Ton und erforderliche Terminologie geprüft werden.

Anfragekörper

curl --request POST \
  --url https://api.detecting-ai.com/api/humanize/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: humanizer-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to rewrite.",
    "model": "cognia"
  }'

Antwort

{
  "humanized_text": "The rewritten text is returned here.",
  "words_processed": 120,
  "model_used": "cognia"
}

Übersicht zur KI-Humanizer-API lesen

REST-Endpunkt

API zur Plagiatsprüfung

Suchen Sie nach Überschneidungen auf Satzebene und geben Sie bei einem Treffer Quellenkontext zurück. Eine Übereinstimmung braucht menschliche Prüfung, weil Zitate, Belege, Erlaubnis und Standardformulierungen ihre Bedeutung beeinflussen.

Anfragekörper

curl --request POST \
  --url https://api.detecting-ai.com/api/plagiarism/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: plagiarism-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to check."
  }'

Antwort

{
  "result": {
    "results": [
      {
        "sentence": "A sentence from the input.",
        "is_plagiarised": true,
        "web_sentence": "A similar source sentence.",
        "similarity": 91.0,
        "link": "https://example.com/source"
      }
    ],
    "plagiarism_score": 34.2
  },
  "words_processed": 120
}

Übersicht zur API für die Plagiatsprüfung lesen

Streamable HTTP

Remote-MCP-Server

Ein Remote-MCP-Server stellt genau zwei Werkzeuge bereit: detect_ai_text und humanize_text. Die Plagiatsprüfung ist über REST verfügbar, nicht über MCP.

Gehostete Konnektoren

Fügen Sie in einem gehosteten Konnektor nur die MCP-URL hinzu. Der Client erkennt OAuth, öffnet die Anmelde- und Einwilligungsseite im Browser und speichert seine eigenen Token. Hängen Sie keinen API-Schlüssel oder andere Zugangsdaten an die URL an.

Codex

export DETECTING_AI_API_KEY="YOUR_API_KEY"

[mcp_servers.detecting_ai]
url = "https://api.detecting-ai.com/api/mcp"
bearer_token_env_var = "DETECTING_AI_API_KEY"
tool_timeout_sec = 300

Claude Code

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer YOUR_API_KEY" \
  detecting-ai https://api.detecting-ai.com/api/mcp

Fehlerbehandlung

Fehler

Prüfen Sie sowohl den HTTP-Status als auch den Antwortkörper. Fehlerantworten sind noch nicht in einem universellen Schema vereinheitlicht.

Kontingente und Grenzen

Nutzung und Grenzen

Die Nutzung wird anhand der durch Leerzeichen getrennten Eingabewörter abgerechnet. Detektor-, Humanizer- und Plagiatsguthaben sind funktionsbezogen, auch wenn derselbe Schlüssel auf mehrere Produkte zugreift.

• Prüfen Sie verbleibende Wörter und aktive Tarife im API-Dashboard.
• MCP verwendet dasselbe Detektor- oder Humanizer-Guthaben wie die entsprechende REST-API.
• REST und MCP begrenzen Text standardmäßig auf 160.000 Zeichen. MCP hat außerdem ein Transportlimit von 1 MiB für den Anfragekörper. Teilen Sie ungewöhnlich große Dokumente in sinnvolle Abschnitte.