REST-API / Textüberarbeitung

KI-Humanizer-API für bearbeitbare, natürliche Neufassungen

Senden Sie einen Entwurf, wählen Sie ein Humanizer-Modell und erhalten Sie eine neue Fassung in Ihrem eigenen Arbeitsablauf. Die Antwort lässt sich leicht bearbeiten, vergleichen und freigeben, bevor sie veröffentlicht wird.

Verwenden Sie den Schlüssel in einer privaten Serverumgebung.

cURL-Anfrage
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"
  }'
01

POST-Anfragen an /api/humanize/

02

Authentifizierung mit X-API-Key

03

Clientseitiger Idempotency-Key für sicher wiederholbare Anfragen

04

Vier unterstützte Modelle

05

Wortnutzung in jeder Antwort

Ein kontrollierbarer Überarbeitungsschritt

Quelle, Neufassung und Endredaktion in einem Ablauf

Eine sinnvolle Humanizer-Integration verschleiert Änderungen nicht. Speichern Sie das Original, fordern Sie eine Neufassung an und geben Sie der Redaktion eine übersichtliche Ansicht, in der sie beide Versionen vor der Freigabe vergleichen kann.

Einfache JSON-Eingabe

Senden Sie den Entwurf und den Namen eines unterstützten Modells. Die Antwort enthält Klartext sowie Modell und Anzahl der verarbeiteten Wörter.

Die Modellwahl bleibt eindeutig

Wählen Sie cognia, lexi, cognia_v2 oder huma_v2 nach dem Verhalten, das Ihr Team für seine eigenen Inhalte getestet hat.

Für die Bearbeitung gedacht

Geben Sie den zurückgegebenen Text wieder in einen Editor, eine Überarbeitungswarteschlange oder ein Inhaltssystem, anstatt ihn als fertiges Werk zu behandeln.

Anfragevertrag

Entwurf senden und Modell benennen

Beide Felder sind für den REST-Endpunkt erforderlich. Hinterlegen Sie die Modellwahl in der Konfiguration, damit sie ohne Umbau der Integration getestet und geändert werden kann.

FeldTypErforderlichFunktion
textstringJaDer übermittelte Text, den der Dienst umschreiben soll.
modelstringJaEiner der Werte cognia, lexi, cognia_v2 oder huma_v2.

Drei Felder machen das Ergebnis leicht nachvollziehbar

Verwenden Sie humanized_text als bearbeitbares Ergebnis. Speichern Sie model_used und words_processed daneben, damit Support, Abrechnung und Redaktion nachvollziehen können, wie die Anfrage ausgeführt wurde.

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

Integrationsablauf

Textüberarbeitung als redaktionellen Schritt behandeln

Ein verlässlicher Ablauf hält das Original sichtbar und lässt die neue Fassung von einem Menschen freigeben.

  1. 1

    API-Schlüssel schützen

    Speichern Sie den Schlüssel auf Ihrem Server oder in einer Geheimnisverwaltung. Legen Sie ihn nicht in öffentlichem Browsercode oder einem geteilten Dokument ab.

  2. 2

    Text mit einem getesteten Modell senden

    Wählen Sie ein unterstütztes Modell, speichern Sie vor dem Versand einen eindeutigen Idempotency-Key und verwenden Sie diesen Schlüssel nur für die identische Wiederholung einer Anfrage.

  3. 3

    Prüfen und freigeben

    Prüfen Sie den umgeschriebenen Text auf Richtigkeit, Bedeutung, Ton und erforderliche Terminologie, bevor Sie ihn speichern oder veröffentlichen.

Geeignete Einsätze

Praktisch für Produkte mit einem bestehenden Editor

Die KI-Textüberarbeitung ist am nützlichsten, wenn ein Entwurf bereits geprüft wird. Die API ergänzt eine Option zum Umschreiben, ohne die für den endgültigen Wortlaut verantwortlichen Menschen zu ersetzen.

Eine Neufassung kann die Bedeutung verändern

Namen, Zitate, Zahlen, Rechtstexte und Fachbegriffe müssen sorgfältig geprüft werden. Halten Sie diese Angaben für die prüfende Person sichtbar.

Content-Management

Bieten Sie in einem CMS eine Umschreibungsaktion an und geben Sie das Ergebnis zum Vergleich und zur Freigabe in denselben Entwurf zurück.

Supportabläufe

Formulieren Sie freigegebenes Ausgangsmaterial als verständlicheren Hilfetext neu und unterziehen Sie ihn anschließend der üblichen Fakten- und Richtlinienprüfung.

Redaktionelle Warteschlangen

Stellen Sie eine Neufassung neben das Original, damit die Redaktion einzelne Änderungen übernehmen, zusammenführen oder ablehnen kann.

Private Schreibwerkzeuge

Rufen Sie den Dienst von einem vertrauenswürdigen Backend auf und zeigen Sie nur den zurückgegebenen Text an, den der angemeldete Benutzer benötigt.

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-Humanizer-API?+

Senden Sie eine POST-Anfrage an https://api.detecting-ai.com/api/humanize/. Verwenden Sie JSON, übermitteln Sie Ihren Schlüssel in X-API-Key und speichern Sie für jeden logischen Vorgang einen stabilen Idempotency-Key, damit Wiederholungen nach Fehlern möglich sind.

Welche Humanizer-Modelle sind verfügbar?+

Die unterstützten Modellwerte sind cognia, lexi, cognia_v2 und huma_v2. Die REST-API erwartet in jeder Anfrage das Feld model.

Was enthält die Antwort?+

Eine erfolgreiche Antwort enthält humanized_text, words_processed und model_used. Der umgeschriebene Text bleibt in Ihrem Produkt bearbeitbar.

Sollte die API-Ausgabe ungeprüft veröffentlicht werden?+

Nein. Prüfen Sie Bedeutung, Fakten, Ton, Namen, Links und alle Formulierungen, die exakt bleiben müssen. Eine Neufassung kann den Lesefluss verbessern und dennoch eine Redaktion benötigen.

Wie wird die Humanizer-Nutzung gezählt?+

Die Nutzung richtet sich nach der Wortzahl der Eingabe und wird vom Humanizer-Guthaben des API-Abonnements abgezogen. Erfolgreiche Antworten melden words_processed.

Erste Anfrage erstellen

Testen Sie die Neufassung an einem vertrauten Text

Beginnen Sie mit einem Modell, vergleichen Sie das Ergebnis mit der Quelle und legen Sie fest, welche Prüfungen Ihre Redaktion vor dem Produktivstart braucht.