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.
REST-API / Textüberarbeitung
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 --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"
}'POST-Anfragen an /api/humanize/
Authentifizierung mit X-API-Key
Clientseitiger Idempotency-Key für sicher wiederholbare Anfragen
Vier unterstützte Modelle
Wortnutzung in jeder Antwort
Ein kontrollierbarer Überarbeitungsschritt
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.
Senden Sie den Entwurf und den Namen eines unterstützten Modells. Die Antwort enthält Klartext sowie Modell und Anzahl der verarbeiteten Wörter.
Wählen Sie cognia, lexi, cognia_v2 oder huma_v2 nach dem Verhalten, das Ihr Team für seine eigenen Inhalte getestet hat.
Geben Sie den zurückgegebenen Text wieder in einen Editor, eine Überarbeitungswarteschlange oder ein Inhaltssystem, anstatt ihn als fertiges Werk zu behandeln.
Anfragevertrag
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.
| Feld | Typ | Erforderlich | Funktion |
|---|---|---|---|
| text | string | Ja | Der übermittelte Text, den der Dienst umschreiben soll. |
| model | string | Ja | Einer der Werte cognia, lexi, cognia_v2 oder huma_v2. |
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.
{
"humanized_text": "The rewritten text is returned here.",
"words_processed": 8,
"model_used": "cognia"
}Integrationsablauf
Ein verlässlicher Ablauf hält das Original sichtbar und lässt die neue Fassung von einem Menschen freigeben.
Speichern Sie den Schlüssel auf Ihrem Server oder in einer Geheimnisverwaltung. Legen Sie ihn nicht in öffentlichem Browsercode oder einem geteilten Dokument ab.
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.
Prüfen Sie den umgeschriebenen Text auf Richtigkeit, Bedeutung, Ton und erforderliche Terminologie, bevor Sie ihn speichern oder veröffentlichen.
Geeignete Einsätze
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.
Namen, Zitate, Zahlen, Rechtstexte und Fachbegriffe müssen sorgfältig geprüft werden. Halten Sie diese Angaben für die prüfende Person sichtbar.
Bieten Sie in einem CMS eine Umschreibungsaktion an und geben Sie das Ergebnis zum Vergleich und zur Freigabe in denselben Entwurf zurück.
Formulieren Sie freigegebenes Ausgangsmaterial als verständlicheren Hilfetext neu und unterziehen Sie ihn anschließend der üblichen Fakten- und Richtlinienprüfung.
Stellen Sie eine Neufassung neben das Original, damit die Redaktion einzelne Änderungen übernehmen, zusammenführen oder ablehnen kann.
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
Beginnen Sie mit einer serverseitigen Anfrage, protokollieren Sie die Antwortstruktur und fügen Sie das Ergebnis dann Ihrem bestehenden Prüfablauf hinzu.
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.
Die unterstützten Modellwerte sind cognia, lexi, cognia_v2 und huma_v2. Die REST-API erwartet in jeder Anfrage das Feld model.
Eine erfolgreiche Antwort enthält humanized_text, words_processed und model_used. Der umgeschriebene Text bleibt in Ihrem Produkt bearbeitbar.
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.
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
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.